Working with Comments

การทํางานกับความคิดเห็น

Aspose.Cells FOSS for Java lets you add, read, modify, and remove cell ความเห็น (ความหมาย) ในหนังสือทํางาน XLSX. การเข้าถึงความคิดเห็นผ่านการใช้งานของ CommentCollection ในใบทํางาน และแสดงเป็น Comment อัตถุประกอบ ที่มีข้อความหมายเหตุ ชื่อผู้เขียน และขนาดการแสดง.

ภาพรวม

แผ่นงานแต่ละใบแสดงความคิดเห็นของตนเองผ่านการใช้ Worksheet.getComments(), ซึ่ง กลับ a CommentCollection.คุณสามารถเพิ่มความคิดเห็นโดยทางโทรศัพท์มือถือ หรือผ่าน อินเด็กซ์แถว/คอลัมน์ ค้นหาความคิดเห็นที่มีอยู่ตามชื่ออินเด็คสหรือเซลล์ และ ถอดมันไปเมื่อไม่จําเป็นอีกต่อไป.

A การทําการ 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) เพื่อใส่ความคิดเห็นใหม่ ทั้งสองการอุดตัน กลับ a 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() (ในพิกเซล) เพื่อให้แน่ใจว่า กล่องบันทึกใหญ่พอสําหรับข้อความหลายแถว.
ชื่อผู้เขียนถูกเก็บเป็นเส้นประโยคธรรมดา; พวกเขาไม่ได้รับการยืนยันกับรายชื่อผู้ใช้ของหนังสือทํางาน.
ความเห็นรอดการอัตราบรรจุ/บันทึกรอบทางผ่าน XLSX เมื่อไม่มีการปรับเปลี่ยน ได้รับการจัดทําเพื่อ CommentCollection.

ปัญหาทั่วไป

Issue	Cause	แก้ไข
`get(cellName)` การคืนสินค้า `null`	ไม่มีคําพูดที่อยู่นั้น	ตรวจสอบที่อยู่เซลล์หรือซ้ําตามอัตรานิยาม
บทความที่เขียนเป็นเปล่าหลังจากการบันทึก	`setNote()` ไม่เรียกก่อนการบันทึก	Call `setNote()` ในการกลับ `Comment` ก่อนการบันทึกหนังสือทํางาน
ความเห็นไม่เห็นใน Excel	`setVisible(false)` ได้ตั้งค่า	เปลี่ยนไปเป็น `setVisible(true)` หรือเลื่อนบนเซลล์ใน Excel

FAQ

ผมเพิ่มความคิดเห็นในแถวและคอลัมน์ที่จํากัดอย่างไร?

การใช้งาน CommentCollection.add(row, column), โดยค่าทั้งสองเป็นหลักศูนย์ อัตราล่วงหน้านี้เท่ากับ add(cellName) ด้วยเซลล์ที่ตรงกัน ที่อยู่.

ผมเปลี่ยนผู้เขียนของความคิดเห็นที่มีอยู่ได้หรือไม่?

ใช่ เอาไปเอาคืน Comment ผ่าน get(cellName) และโทรหา setAuthor(name) กับการเขียนใหม่ของผู้แต่ง.

วิธีการตรวจสอบว่าความคิดเห็นจะสามารถมองได้หรือไม่?

Call Comment.isVisible().การคืนเงิน true ถ้ากรอบความคิดเห็นจะอยู่เสมอ แสดงไว้; false ถ้ามันปรากฏเพียงแค่บนการระยับ.

ความเห็นถูกรักษาไว้เมื่อแปลงเป็นรูปแบบอื่นไหม?

ความคิดเห็นถูกรักษาไว้ใน XLSX ไป-กลับ. การรักษาการสําหรับรูปแบบอื่น ๆ ขึ้นอยู่กับการสนับสนุนรูป แบบในการออกผลิตเป้าหมาย.

ผมนับความคิดเห็นในตารางงานอย่างไร?

การใช้งาน Worksheet.getComments().getCount().

คําอธิบายการพบบ่อย API

Comment

Method	ประเภทการคืน	Description
`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

Method	ประเภทการคืน	Description
`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