کار با نظرات

کار با نظرات

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، که با رفتار استاندارد اکسل مطابقت دارد.
• استفاده از Comment.setWidth() و Comment.setHeight() (در پیکسل ها) برای اطمینان از جعبه یادداشت به اندازه کافی بزرگ برای متن چند خطی است.
• نام نویسنده به صورت خطوط صاف ذخیره می شود؛ آنها در برابر لیست کاربران کتاب کار تایید نمی شوند.
• نظرات زنده ماندن یک بار / ذخیره چرخش از طریق XLSX زمانی که هیچ تغییرات ساخته شده برای CommentCollection.

مسائل مشترک

FAQ

چگونه می توانم یک نظر را در یک ردیف و ستون خاص اضافه کنم؟?

استفاده از CommentCollection.add(row, column),در آن هر دو ارزش بر اساس صفر است. شاخص ها: این معادل add(cellName) با سلول های مربوطه آدرس .

آیا می توانم نویسنده یک نظر فعلی را تغییر دهم؟?

بله، بازگردانید Comment از طریق get(cellName) و تماس setAuthor(name) با نویسنده جدیدی که در آن قرار دارد.

چگونه می توانم بررسی کنم که آیا در حال حاضر یک نظر قابل مشاهده است؟?

Call Comment.isVisible().بازگشت true اگر جعبه نظرات همیشه در دسترس باشد نشان داده شده است؛; false اگر فقط در حفره ظاهر شود.

آیا نظرات در هنگام تبدیل به فرمت های دیگر حفظ می شود؟?

نظرات در XLSX دور نگه داشته می شود رفتار حفظ برای فرمت های دیگر بستگی به پشتیبانی از فرم در خروجی هدف دارد.

چگونه می توانم نظرات را در یک دفترچه کار شمارش کنم؟?

استفاده از Worksheet.getComments().getCount().

API خلاصه ای از ارجاعات

Comment

CommentCollection

همچنین ببینید:

• Aspose.Cells for Java — Enterprise Documentation