Làm việc với bình luận

Làm việc với bình luận

Aspose.Cells FOSS for Java lets you add, read, modify, and remove cell bình luận (các ghi chú) trong XLSX sổ làm việc. bình chọn được truy cập thông qua các bài viết CommentCollection trên một bảng tính và được trình bày như: Comment đối tượng mà mang lại văn bản ghi chú, tên tác giả và kích thước hiển thị.

Overview

Mỗi bài viết đều trình bày những bình luận của mình thông qua Worksheet.getComments(), mà Trở lại a CommentCollection.Bạn có thể thêm một bình luận qua địa chỉ ô hoặc bằng cách index hàng/column, thu thập các bình luận hiện có bằng index hoặc tên ô; và Xóa chúng khi không còn cần thiết nữa.

A Comment Đặt bài viết (getNote()/setNote()) tác giả (getAuthor()/setAuthor()(Những vị trí của Anchor)getRow(), getColumn()(Dân trí) - Các hình ảnh của bạn (getWidth(), getHeight()) và (Những gì có thể thấy được bằng cách mặc định)isVisible()/setVisible()).

Truy cập bình luận trên một bảng điều khiển

Retrieve các CommentCollection Từ bất kỳ Worksheet qua Worksheet.getComments().Sử dụng CommentCollection.getCount() để xác định có bao nhiêu bình luận hiện diện. bình chọn cá nhân được truy cập bởi Chỉ số dựa trên zero CommentCollection.get(index) hoặc theo tên cell qua CommentCollection.get(cellName).

Thêm một bình luận

Sử dụng CommentCollection.add(cellName) hoặc CommentCollection.add(row, column) để thêm một bình luận mới. cả hai quá tải trở lại a Comment - Thiết lập văn bản ghi chú và tác giả trên phần trả về Tiếp theo: Trước khi tiết kiệm.

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

Đọc Comment Content

Tải về tất cả các bình luận bằng cách sử dụng số:

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

Thay đổi một bình luận hiện có

Xác định bình luận bằng địa chỉ ô và cập nhật các trường của nó trực tiếp:

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

Xóa một bình luận

Sử dụng CommentCollection.removeAt(index) hoặc CommentCollection.removeAt(cellName) Để xóa một bình luận:

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

Mẹo và Thực hành Tốt nhất

• Luôn kiểm tra điều này CommentCollection.get(cellName) Không trở lại null trước khi sửa đổi một bình luận – ô có thể không có bình chọn được gắn.
• Set Đặt Comment.setVisible(false) Đối với các ghi chú mà chỉ nên xuất hiện trên hover, phù hợp với hành vi Excel tiêu chuẩn.
• Sử dụng Comment.setWidth() và Comment.setHeight() (trong pixels) để đảm bảo hộp ghi chú đủ lớn để có văn bản đa tuyến.
• Tên tác giả được lưu trữ như các dòng thẳng; chúng không được xác nhận chống lại danh sách người dùng của sổ làm việc.
• Bình luận sống sót một tải / tiết kiệm vòng qua XLSX khi không có sửa đổi được làm cho CommentCollection.

Các vấn đề thường gặp

FAQ

Làm thế nào để tôi thêm một bình luận vào một hàng và cột cụ thể?

Sử dụng CommentCollection.add(row, column),Trong đó cả hai giá trị đều dựa trên zero. Tỷ lệ: Điều này tương đương với add(cellName) với các tế bào tương ứng Địa chỉ.

Tôi có thể thay đổi tác giả của một bình luận hiện tại không?

• Có. lấy lại Comment qua get(cellName) và gọi setAuthor(name) với tác giả mới string.

Làm thế nào để tôi kiểm tra xem một bình luận hiện có thể nhìn thấy?

Call Comment.isVisible().- Trở lại true Nếu hộp bình luận luôn là Hiển thị; false Nếu nó chỉ xuất hiện trên hover.

Các bình luận được lưu trữ khi chuyển đổi sang các định dạng khác?

Các bình luận được lưu trữ trên XLSX vòng. hành vi bảo tồn cho các định dạng khác phụ thuộc vào hỗ trợ định hình trong kết quả mục tiêu.

Làm thế nào để tôi tính toán bình luận trên một bảng điều khiển?

Sử dụng Worksheet.getComments().getCount().

Tóm tắt Tham chiếu API

Comment

CommentCollection

See Also

• Aspose.Cells for Java — Enterprise Documentation