टिप्पणियों के साथ काम करना
टिप्पणियों के साथ काम करना
Aspose.Cells FOSS for Java lets you add, read, modify, and remove cell टिप्पणियाँ (नोट) में XLSX कार्यपुस्तिका. टिप्पणी के माध्यम से पहुंच की जाती है CommentCollection एक कार्यपत्रक पर और प्रतिनिधित्व के रूप में प्रस्तुत किया गया है Comment वस्तुओं जो नोट पाठ, लेखक का नाम और प्रदर्शन आयाम ले जाता है।.
अवलोकन
प्रत्येक कार्यपत्रक अपने टिप्पणियों को प्रस्तुत करता है Worksheet.getComments(),जिसके लौटें A CommentCollection.आप एक टिप्पणी को सेल पते के माध्यम से या द्वारा जोड़ सकते हैं क्रम / स्तंभ सूचकांक, सूचक या सेल नाम के साथ मौजूदा टिप्पणियों को प्राप्त करें, और जब जरूरत नहीं तो उन्हें हटा दें।.
A Comment नोटबुक का पाठ (getNote()/setNote()) लेखक के लिए (getAuthor()/setAuthor()इसके लिए एंटीबायोटिक (getRow(), getColumn()इसके लिए अपनी आकार की मात्रा (getWidth(), getHeight()) और क्या यह अविश्वसनीय है (isVisible()/setVisible()).
एक कार्यपत्रक पर टिप्पणियों का उपयोग करें
रिटर्न करें CommentCollection किसी भी से Worksheet के माध्यम से Worksheet.getComments().उपयोग करें CommentCollection.getCount() निर्धारित करने के लिए कितने टिप्पणियाँ मौजूद हैं. व्यक्तिगत टिप्पणी उपलब्ध है द्वारा 0 के आधार पर इंडेक्स CommentCollection.get(index) या सेल नाम के अनुसार के माध्यम से CommentCollection.get(cellName).
एक टिप्पणी जोड़ें
उपयोग करें CommentCollection.add(cellName) या CommentCollection.add(row, column) एक नया टिप्पणी लिखें. दोनों का असर लौटें A Comment नोट पाठ और लेखक को वापस भेजने पर सेट करें बचत से पहले की बात है।.
// Add a comment to cell B2 and configure it
Comment comment = ws.getComments().add("B2");
comment.setNote("Review this value before submission.");
comment.setAuthor("Analyst");
comment.setVisible(false);
comment.setWidth(180);
comment.setHeight(60);पढ़ने के लिए टिप्पणी सामग्री
सभी टिप्पणियों को गिनती का उपयोग करके संदर्भित करें:
CommentCollection comments = ws.getComments();
for (int i = 0; i < comments.getCount(); i++) {
Comment c = comments.get(i);
System.out.printf("Cell [%d,%d] author=%s note=%s%n",
c.getRow(), c.getColumn(), c.getAuthor(), c.getNote());
}एक मौजूदा टिप्पणी को बदलना
टिप्पणी को सेल पते के माध्यम से पुनर्स्थापित करें और सीधे अपने फ़ील्ड को अपडेट करें:
Comment c = ws.getComments().get("B2");
if (c != null) {
c.setNote("Updated note text.");
c.setVisible(true);
}एक टिप्पणी हटाने के लिए
उपयोग करें CommentCollection.removeAt(index) या CommentCollection.removeAt(cellName) एक टिप्पणी को हटाने के लिए:
ws.getComments().removeAt("B2");टिप्स और सर्वश्रेष्ठ अभ्यास
- हमेशा इस बात की जांच करें
CommentCollection.get(cellName)नहीं लौटते हैंnullटिप्पणी को संशोधित करने से पहले - सेल में कोई टिप्पणियाँ नहीं हो सकती हैं।. - सेट
Comment.setVisible(false)इनमें से कुछ के लिए जो केवल उपस्थिति में दिखाई देना चाहिए। hover, जो मानक Excel व्यवहार के अनुरूप है।. - उपयोग करें
Comment.setWidth()औरComment.setHeight()(पिक्सेल में) सुनिश्चित करने के लिए नोटबुक बहु-लाइन पाठ के लिए पर्याप्त बड़ा है।. - लेखक नामों को सीधे पंक्तियों के रूप में संग्रहीत किया जाता है; वे कार्यपुस्तिका के उपयोगकर्ता सूची के खिलाफ वैध नहीं होते हैं।.
- टिप्पणियाँ XLSX के माध्यम से एक लोड / बचाव दौर-ट्रिप पर जीवित रहें जब कोई परिवर्तन नहीं होते हैं बनाया गया है
CommentCollection.
सामान्य मुद्दे
| Issue | Cause | फिक्स करें |
|---|---|---|
get(cellName) लौटें null | इस संदर्भ में कोई टिप्पणी नहीं | सेल पता या इंडेक्स द्वारा इटेरेट करें देखें |
| टिप्पणी नोट बचाने के बाद खाली है | setNote() बचाने से पहले नहीं बुलाया | Call setNote() वापस लौटने के लिए Comment काम की किताब बचाने से पहले |
| Excel में नहीं दिखाई देता है टिप्पणी | setVisible(false) सेट किया गया था | बदलाव के लिए setVisible(true) या Excel में सेल के ऊपर घूमना |
FAQ
मैं एक विशिष्ट पंक्ति और स्तंभ में टिप्पणी कैसे जोड़ सकता हूं?
उपयोग करें CommentCollection.add(row, column),जहां दोनों मूल्य शून्य आधारित हैं यह एक समान है. यह के बराबर है add(cellName) संबंधित सेल के साथ पता है।.
क्या मैं एक मौजूदा टिप्पणी के लेखक को बदल सकता हूं?
हाँ, वापस ले लो Comment के माध्यम से get(cellName) और कॉल करें setAuthor(name) नए लेखक के साथ।.
मैं कैसे जांच सकता हूं कि क्या एक टिप्पणी वर्तमान में दिखाई देती है?
Call Comment.isVisible().लौटें true अगर हमेशा टिप्पणी बॉक्स में रहता है दिखाई देती है; false यदि यह केवल हव पर दिखाई देता है।.
टिप्पणियाँ अन्य प्रारूपों में परिवर्तित करते समय संरक्षित हैं?
टिप्पणियाँ XLSX पर रखा जाता है. अन्य प्रारूपों के लिए संरक्षण व्यवहार लक्ष्य आउटपुट में प्रारंभिक समर्थन पर निर्भर करता है।.
एक कार्यपत्रक पर टिप्पणियों की गिनती कैसे करें?
उपयोग करें Worksheet.getComments().getCount().
API संदर्भ सारांश
Comment
| Method | वापसी प्रकार | Description |
|---|---|---|
getRow() | int | एंकोर सेल के शून्य-आधारित क्रम सूचकांक।. |
getColumn() | int | एंकोर सेल के शून्य-आधारित स्तंभ सूचकांक।. |
getNote() | String | टिप्पणी पाठ है।. |
setNote(note) | void | टिप्पणी पाठ बनाएं।. |
getAuthor() | String | लेखक का नाम है।. |
setAuthor(author) | void | लेखक का नाम लिखें।. |
isVisible() | boolean | टिप्पणी बॉक्स हमेशा दिखाई देता है।. |
setVisible(visible) | void | टिप्पणी बॉक्स की दृश्यता को निर्धारित करें।. |
getWidth() | int | पिक्सेल में टिप्पणी बॉक्स की चौड़ाई।. |
setWidth(width) | void | टिप्पणी बॉक्स की चौड़ाई निर्धारित करें।. |
getHeight() | int | पिक्सेल में टिप्पणी बॉक्स की ऊंचाई।. |
setHeight(height) | void | टिप्पणी बॉक्स की ऊंचाई निर्धारित करें।. |
CommentCollection
| Method | वापसी प्रकार | Description |
|---|---|---|
getCount() | int | कार्यपत्रक पर टिप्पणियों की संख्या।. |
get(index) | Comment | 0-आधारित सूचकांक पर टिप्पणी वापस करें।. |
get(cellName) | Comment | टिप्पणी को दिए गए सेल पते पर वापस करें।. |
add(row, column) | Comment | एक नया टिप्पणी क्रम / स्तंभ स्थिति में जोड़ें।. |
add(cellName) | Comment | सेल पते पर एक नया टिप्पणी जोड़ें।. |
removeAt(index) | void | 0-आधारित सूचकांक पर टिप्पणी हटा दें।. |
removeAt(cellName) | void | सेल पते पर टिप्पणी हटा दें।. |