Working with Comments

Lucrarea cu comentariile

Aspose.Cells FOSS for Java lets you add, read, modify, and remove cell comentarii (notițe) în cărțile de lucru XLSX. CommentCollection pe o foaie de calcul și sunt reprezentate ca: Comment obiectele care conțin textul notiței, numele autorului și dimensiunile afișării.

Prezentare generală

Fiecare fișă de lucru își expune comentariile prin: Worksheet.getComments(), care returnează un CommentCollection.Poţi adăuga un comentariu prin adresa mobilului sau prin: indexul rândului/colonilor, obținerea comentariilor existente pe indice sau nume de celulă și scoate-le când nu mai e nevoie.

A. În cazul în care: Comment stochează textul de notă (getNote()/setNote()), autorul (getAuthor()/setAuthor()), poziția de ancorare (getRow(), getColumn()), dimensiunile de afișare (getWidth(), getHeight()), și dacă este vizibil în mod implicit (isVisible()/setVisible()).

Accesarea comentariilor pe o foaie de lucru

Obţineţi… CommentCollection de la orice Worksheet prin intermediul Worksheet.getComments().- Foloseste-l . CommentCollection.getCount() pentru a determina Numărul de comentarii este disponibil la: Indicele pe bază de zero prin CommentCollection.get(index) sau după numele celulei. prin intermediul CommentCollection.get(cellName).

Adăugarea unui comentariu

Utilizare: CommentCollection.add(cellName) sau de: CommentCollection.add(row, column) Ambele supraîncărcări de date sunt înregistrată. returnarea a Comment Obiect. Setarea textului de notă și autor pe returnat În cazul în care se foloseşte o instanţă înainte de a salva.

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

Citirea conținutului comentariilor

Iterati toate comentariile folosind numarul:

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

Modificarea unui comentariu existent

Obțineți comentariul prin adresa celulară și actualizați câmpurile sale direct:

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

Eliminarea unui comentariu

Utilizare: CommentCollection.removeAt(index) sau de: CommentCollection.removeAt(cellName) pentru a șterge un comentariu:

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

Sfaturi şi cele mai bune practici

Verifică mereu asta. CommentCollection.get(cellName) nu se întoarce. null înainte de modificarea unui comentariu celula poate să nu aibă nici un comentariat atașat.
Setare Comment.setVisible(false) pentru anotațiile care ar trebui să apară numai pe hover, care se potrivește comportamentului standard Excel.
Utilizare: Comment.setWidth() și de: Comment.setHeight() (în pixeli) pentru a asigura cutia de notițe este suficient de mare pentru text multi-linee.
Numele autorilor sunt stocate ca șiruri simple; nu sunt validate față de lista utilizatorilor din carte.
Comentariile supraviețuiesc încărcării/salvării prin XLSX atunci când nu există modificări. sunt realizate pentru: CommentCollection.

Probleme comune

Numărul de date	Cauza	Fixare
`get(cellName)` rambursări `null`	Nu există comentarii la adresa respectivă.	Verificați adresa celulei sau iterationați după index
Notă de comentariu este goală după salvare	`setNote()` Nu a fost sunat înainte de salvare.	Sună-mă. `setNote()` pe retur `Comment` înainte de a salva cartea de lucru
Comentariul nu este vizibil în Excel	`setVisible(false)` a fost stabilită	Schimbare la: `setVisible(true)` sau faceți-l să treacă peste celulă în Excel

FAQ

Cum adaug un comentariu la o anumită rând și coloană?

Utilizare: CommentCollection.add(row, column), unde ambele valori sunt bazate pe zero. Acest lucru este echivalent cu add(cellName) cu celula corespunzătoare Adresa.

Pot schimba autorul unui comentariu existent?

Da, să-l recuperez. Comment prin intermediul get(cellName) şi sună-l. setAuthor(name) cu noul șir de autor.

Cum verific dacă un comentariu este vizibil în prezent?

Sună-mă. Comment.isVisible().Retourări true dacă caseta de comentarii este întotdeauna prezentate; false dacă apare doar pe hover.

Sunt păstrate comentariile atunci când sunt convertite în alte formate?

Comentariile sunt păstrate pe XLSX. Comportamentul de conservare pentru alte formate depinde de suportul formatului în ieșirea țintă.

Cum număr comentariile pe o foaie de lucru?

Utilizare: Worksheet.getComments().getCount().

Rezultatele de la data aplicării.

Comentariul

Metoda de evaluare	Tip de returnare	Descriere:
`getRow()`	`int`	Indicele rândului de bază zero al celulei ancoră.
`getColumn()`	`int`	Indicele de coloană pe bază zero al celulei ancorare.
`getNote()`	`String`	Textul comentariului.
`setNote(note)`	`void`	Setarea textului comentariului.
`getAuthor()`	`String`	Numele autorului.
`setAuthor(author)`	`void`	Stabileşte numele autorului.
`isVisible()`	`boolean`	Dacă caseta de comentarii este întotdeauna vizibilă.
`setVisible(visible)`	`void`	Setarea vizibilității casetei de comentarii.
`getWidth()`	`int`	Lățimea casetelor de comentarii în pixeli.
`setWidth(width)`	`void`	Setarea lățimii casetă de comentarii.
`getHeight()`	`int`	Înălțimea casetelor de comentarii în pixeli.
`setHeight(height)`	`void`	Setarea înălțimii casetă de comentarii.

CommentCollection

Metoda de evaluare	Tip de returnare	Descriere:
`getCount()`	`int`	Numărul de comentarii pe fișă.
`get(index)`	`Comment`	Întoarce comentariul la indexul bazat pe zero.
`get(cellName)`	`Comment`	Întoarce comentariul la adresa de telefon mobil.
`add(row, column)`	`Comment`	Adăugarea unui nou comentariu la poziția rândului/colonnei.
`add(cellName)`	`Comment`	Adaugă un comentariu nou la adresa mobilului.
`removeAt(index)`	`void`	Îndepărtează comentariul la index-n zero.
`removeAt(cellName)`	`void`	Elimină comentariul de la adresa mobilului.

Vezi și:

Aspose.Cells for Java — Enterprise Documentation