Arbeta med kommentarer

Arbeta med kommentarer

Aspose.Cells FOSS for Java lets you add, read, modify, and remove cell kommentarer (noter) i XLSX arbetsböcker. Kommentarer finns tillgängliga via CommentCollection på ett arbetsblad och representeras som Comment föremål som bär anteckningstexten, författarnamn och displaydimensioner.

Översikt

Varje arbetsbok visar sina kommentarer genom att Worksheet.getComments(),och vilken Återkommer A CommentCollection.Du kan lägga till en kommentar via celladress eller genom rad/kolumnindex, få befintliga kommentarer genom index eller cellnamn och Ta bort dem när de inte längre behövs.

A och Comment För att få reda på texten (getNote()/setNote()) författaren (getAuthor()/setAuthor()och dess ankor position (getRow(), getColumn()och dess utseende (getWidth(), getHeight()) och Om det är synligt (isVisible()/setVisible()).

Tillgång till kommentarer på en arbetsbok

återställer den CommentCollection Från någon Worksheet via Worksheet.getComments().Användning CommentCollection.getCount() att bestämma hur många kommentarer finns. individuella kommentarer är tillgängliga genom att Nollbaserad index genom CommentCollection.get(index) eller genom cellnamn genom CommentCollection.get(cellName).

Lägg till en kommentar

Användning CommentCollection.add(cellName) eller CommentCollection.add(row, column) att skriva in en ny kommentar. båda överlämnar Återgå till A Comment objekt. Ställ anteckningstexten och författaren på den returnerade Exempel före sparande.

// 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);

Läs kommentar innehåll

Se alla kommentarer med hjälp av räkningen:

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());
}

Ändra en befintlig kommentar

Reträda kommentaren genom celladress och uppdatera fälten direkt:

Comment c = ws.getComments().get("B2");
if (c != null) {
    c.setNote("Updated note text.");
    c.setVisible(true);
}

Ta bort en kommentar

Användning CommentCollection.removeAt(index) eller CommentCollection.removeAt(cellName) För att radera en kommentar:

ws.getComments().removeAt("B2");

Tips och bästa praxis

• Kontrollera alltid det CommentCollection.get(cellName) inte återvända null innan du ändrar en kommentar – cellen kan inte ha några kommentarer bifogade.
• Setade Comment.setVisible(false) för anmälningar som endast ska visas på hover, som matchar standard Excel beteende.
• Användning Comment.setWidth() och Comment.setHeight() (i pixlar) för att säkerställa Notfönstret är tillräckligt stort för flerlinjetext.
• Författarnamn lagras som platt strängar; de valideras inte mot arbetsbokens användarlista.
• Kommentarer överleva en laddning/spara rundtur genom XLSX när inga ändringar De är gjorda för CommentCollection.

Vanliga frågor

FAQ

Hur lägger jag till en kommentar i en viss rad och kolumn?

Användning CommentCollection.add(row, column),där båda värdena är nollbaserade index. detta motsvarar add(cellName) med motsvarande celler adressen .

Kan jag ändra författaren till en befintlig kommentar?

Ja, återställ den Comment via get(cellName) och ringer setAuthor(name) med den nya författaren sträng.

Hur kan jag kontrollera om en kommentar är synlig för närvarande?

Call Comment.isVisible().Återvändning true Om kommentarsfältet alltid är visar sig; false Om det bara visas på hover.

Är kommentarer bevarade när du konverterar till andra format?

Kommentarer bevaras på XLSX rundtur. Bevarandebehandlingen för andra format beror på formatsstöd i målresultatet.

Hur räknar jag kommentarer på ett arbetsblad?

Användning Worksheet.getComments().getCount().

API Referens sammanfattning

Comment

CommentCollection

Se även

• Aspose.Cells for Java — Enterprise Documentation