Working with Comments

Εργασία με σχόλια

Aspose.Cells FOSS for Java lets you add, read, modify, and remove cell σχόλια (ενόχληση) σε βιβλία εργασίας XLSX. Comments are accessed through the 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) για τις αναφορές που θα πρέπει να εμφανίζονται μόνο σε Hover, η οποία ταιριάζει με τη συμπεριφορά του Excel.
Χρησιμοποιήστε Comment.setWidth() και Comment.setHeight() (σε pixels) για να εξασφαλιστεί η Το κουτί σημειώσεων είναι αρκετά μεγάλο για το πολυγραμμικό κείμενο.
Τα ονόματα των συγγραφέων αποθηκεύονται ως επίπεδα, δεν επικυρώνονται κατά τη λίστα χρηστών του βιβλίου εργασίας.
Σχόλια επιβιώνουν μια φόρτιση / αποθηκεύστε ένα γύρο-στρόβιλο μέσω 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 Αν εμφανιστεί μόνο στο χαλί.

Τα σχόλια διατηρούνται όταν μετατρέπεται σε άλλες μορφές;?

Τα σχόλια διατηρούνται στο XLSX round-trip. Η συμπεριφορά διατήρησης για άλλες μορφές εξαρτάται από την υποστήριξη της μορφής στην επίτευξη στόχου.

Πώς να μετρήσω σχόλια σε ένα φύλλο εργασίας;?

Χρησιμοποιήστε Worksheet.getComments().getCount().

Συνοπτική αναφορά API

Πως

Μέθοδος	Τύπος επιστροφής	Περιγραφή
`getRow()`	`int`	Ο δείκτης γραμμής του κελιού anchor με βάση το μηδέν.
`getColumn()`	`int`	Δείκτης στήλης μηδενικής βάσης του κυττάρου anchor.
`getNote()`	`String`	Το κείμενο των σχολίων.
`setNote(note)`	`void`	Εισάγετε το κείμενο σχολίων.
`getAuthor()`	`String`	Το όνομα του συγγραφέα.
`setAuthor(author)`	`void`	Να βάλει το όνομα του συγγραφέα.
`isVisible()`	`boolean`	Το αν το σχόλιο είναι πάντα ορατό.
`setVisible(visible)`	`void`	Εισάγετε την ορατότητα του κουτιού σχολίων.
`getWidth()`	`int`	Το πλάτος του κουτιού σχολίων σε pixels.
`setWidth(width)`	`void`	Εισάγετε το πλάτος του κουτιού σχολίων.
`getHeight()`	`int`	Το ύψος του κουτιού σχολίων σε pixels.
`setHeight(height)`	`void`	Καθορίστε το ύψος του κουτιού σχολίων.

CommentCollection

Μέθοδος	Τύπος επιστροφής	Περιγραφή
`getCount()`	`int`	Αριθμός σχολίων στο βιβλίο εργασίας.
`get(index)`	`Comment`	Επιστρέφει το σχόλιο στο μηδενικό δείκτη.
`get(cellName)`	`Comment`	Επιστρέφει το σχόλιο στην δεδομένη διεύθυνση κυττάρου.
`add(row, column)`	`Comment`	Προσθέστε ένα νέο σχόλιο στη θέση γραμμής/στήλης.
`add(cellName)`	`Comment`	Προσθέστε ένα νέο σχόλιο στην διεύθυνση κελί.
`removeAt(index)`	`void`	Αφαιρέστε το σχόλιο στο μηδενικό δείκτη.
`removeAt(cellName)`	`void`	Αφαιρέστε το σχόλιο στην διεύθυνση κελί.

Δείτε επίσης

Aspose.Cells for Java — Enterprise Documentation