Working with Comments

עבודה עם תגובות

Aspose.Cells FOSS for Java lets you add, read, modify, and remove cell הערות (הערות) בספרים העבודה של XLSX. הערה נגישה דרך CommentCollection על לוח עבודה ומוצג כ Comment אובייקטים שמאחוריו נשמעים טקסט הערה, שם המחבר ומדדים של הצג.

סקירה

כל עיתון מפרט את הערותיו באמצעות Worksheet.getComments(),אשר חוזר א CommentCollection.ניתן להוסיף הערה על ידי כתובת תא או על-ידי רצועה/קטעון, לקבל הערות קיימות על ידי אינדיקטור או שם תא; ו מורידים אותם כאשר כבר לא נדרשים.

א Comment תגיות קשורות טקסט (getNote()/setNote()• המחבר (getAuthor()/setAuthor()• מיקום האנקור (getRow(), getColumn()• מראה המגוון (getWidth(), getHeight()) ו האם זה נראה באופן בלתי צפוי (isVisible()/setVisible()).

גישה לדיווחים על לוח עבודה

להחזיר את CommentCollection מכל אחד Worksheet דרך Worksheet.getComments().שימוש CommentCollection.getCount() כדי לקבוע כמה הערות יש.הערות אישיות זמינות על ידי מדד מבוסס אפס באמצעות CommentCollection.get(index) או בשם תא דרך CommentCollection.get(cellName).

להוסיף הערה

שימוש CommentCollection.add(cellName) או CommentCollection.add(row, column) להוסיף הערה חדשה.שני העומדים על חזרה א 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) על כל התגובות שהיו צריכות להופיע רק ב הוור, אשר תואם התנהגות סטנדרטית של Excel.
שימוש Comment.setWidth() ו Comment.setHeight() (בפיקסלים) כדי להבטיח תיבת ההערות גדולה מספיק כדי להשיג טקסט רב-קו.
שמות המחבר מאוחסנים כשרפים שטוחים; הם אינם מאושרים נגד רשימת המשתמשים של ספר העבודה.
הערות לשרוד משאבה / הצלת סיבוב דרך XLSX כאשר אין שינויים נעשה על ידי CommentCollection.

בעיות נפוצות

נושא	סיבה	קבע
`get(cellName)` חזרה `null`	אין תגובות לכתובת זו	בדוק את כתובת התא או איטרה על ידי אינדיקטור
הערה ריקה לאחר שמירה על	`setNote()` לא התקשר לפני הצלת	שיחת טלפון `setNote()` על החזרה `Comment` לפני שמחזירים את ספר העבודה
לא ניתן לראות במדריך Excel	`setVisible(false)` הוקם	שינוי ל `setVisible(true)` או להסתובב מעל התא ב- Excel

FAQ

כיצד ניתן להוסיף הערה לשורה וסולם מסוים?

שימוש CommentCollection.add(row, column),כאשר שני הערכים מבוססים על אפס. תגיות: זה שווה לזה add(cellName) עם התא המתאים כתובת →.

האם אני יכול לשנות את המחבר של הערה קיימת?

כן, להחזיר את Comment דרך get(cellName) וקוראים setAuthor(name) עם הסופר החדש.

כיצד ניתן לבדוק אם הערה נראית כרגע?

שיחת טלפון Comment.isVisible().חזרה → true אם תיבת ההערות תמיד הוכח על ידי; false אם זה רק מופיע על הוורד.

האם הערות נשמרות בעת ההמרה לתבניות אחרות?

התנהגות ההגנה עבור פורמטים אחרים תלויה בתמיכה בפורמט בהפקה היעד.

איך אני מחשב את ההערות על לוח עבודה?

שימוש Worksheet.getComments().getCount().

סיכום התייחסות API

איך

שיטת	סוג החזרה	תיאור
`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

שיטת	סוג החזרה	תיאור
`getCount()`	`int`	מספר הערות על לוח העבודה.
`get(index)`	`Comment`	החזיר את ההערה ל- null based index.
`get(cellName)`	`Comment`	החזיר את ההערה לכתובת התא.
`add(row, column)`	`Comment`	הוסף הערה חדשה בתנועת שורה/עמודה.
`add(cellName)`	`Comment`	הוסף הערה חדשה לכתובת התא.
`removeAt(index)`	`void`	הסר את ההערה על בסיס אפס.
`removeAt(cellName)`	`void`	הסר את ההערה בכתובת התא.

ראה גם

Aspose.Cells for Java — Enterprise Documentation