العمل مع التعليقات

العمل مع التعليقات

Aspose.Cells FOSS for Java lets you add, read, modify, and remove cell التعليقات (الملاحظات) في كتيبات العمل XLSX. يتم الوصول إلى التعقيدات من خلال الموقع الإلكتروني CommentCollection على ورقة عمل ويتم تمثيلها كـ: Comment الأشياء التي تحمل نص الملاحظة، اسم المؤلف، وأبعاد العرض.

نظرة عامة

كل ورقة عمل تعرض التعليقات من خلال: Worksheet.getComments(),، والتي يعيد a 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) لإدراج تعليق جديد. كلاهما مفرط إرجاع 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) للملاحظات التي يجب أن تظهر فقط على تحريك، الذي يطابق سلوك إكسل القياسي.
• استخدام Comment.setWidth() و Comment.setHeight() (في البكسل) لضمان مربع الملاحظات كبير بما فيه الكفاية للكتابة متعددة السطور.
• يتم تخزين أسماء المؤلفين كسلسلاً عادية؛ لا يتم التحقق من صحةها ضد قائمة المستخدم في دفتر العمل.
• تعليقات البقاء على قيد الحياة تحميل / حفظ جولة من خلال XLSX عندما لا يتم إجراء أي تعديلات. صُنعت لـ… CommentCollection.

القضايا المشتركة

FAQ

كيف أضيف تعليقًا في صفود وعمدة معينة؟?

استخدام CommentCollection.add(row, column),، حيث تكون القيم على أساس الصفر هذا يعادل add(cellName) مع الخلية المقابلة العنوان.

هل يمكنني تغيير مؤلف تعليق موجود؟?

نعم، إسترد المكالمة. Comment عبر get(cellName) و اتصل به setAuthor(name) مع سلسلة المؤلف الجديدة.

كيف يمكنني التحقق من أن التعليق مرئي حالياً؟?

اتصلوا Comment.isVisible(). العوائد true إذا كان مربع التعليق دائماً يظهر:; false إذا كان يظهر فقط على التدفق.

هل يتم الحفاظ على التعليقات عند التحويل إلى تنسيقات أخرى؟?

يتم الحفاظ على التعليقات في XLSX ذهابًا وإيابًًة. يعتمد سلوك الحفظ للنسخ الأخرى على دعم النسخ في المخرج الهدف.

كيف أعد التعليقات على ورقة عمل؟?

استخدام Worksheet.getComments().getCount().

إشارة API

تعليق

CommentCollection

انظر أيضا

• Aspose.Cells for Java — Enterprise Documentation