CommentCollection

CommentCollection class

يوفر وصولاً مكتوبًا إلى مجموعة منComment العقد.

لمعرفة المزيد، قم بزيارةالعمل مع التعليقات مقالة توثيقية.

public class CommentCollection : NodeCollection

الخصائص

اسموصف
Count { get; }يحصل على عدد العقد في المجموعة.
Item { get; }يسترجعComment عند الفهرس المعطى. (2 indexers)

طُرق

اسموصف
Add(Node)يضيف عقدة إلى نهاية المجموعة.
Clear()يزيل جميع العقد من هذه المجموعة ومن المستند.
Contains(Node)يحدد ما إذا كانت العقدة موجودة في المجموعة.
GetEnumerator()يوفر تكرارًا بسيطًا بأسلوب “foreach” عبر مجموعة العقد.
IndexOf(Node)يعيد الفهرس المبني على الصفر للعقدة المحددة.
Insert(int, Node)يقوم بإدراج عقدة في المجموعة عند الفهرس المحدد.
Remove(Node)يزيل العقدة من المجموعة ومن المستند.
RemoveAt(int)يزيل العقدة الموجودة في الفهرس المحدد من المجموعة ومن المستند.
ToArray()نسخ جميع العقد من المجموعة إلى مجموعة جديدة من العقد.

أمثلة

يوضح كيفية وضع علامة “تم” على التعليق.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Writeln("Helo world!");

 //أدرج تعليقًا للإشارة إلى خطأ.
Comment comment = new Comment(doc, "John Doe", "J.D.", DateTime.Now);
comment.SetText("Fix the spelling error!");
doc.FirstSection.Body.FirstParagraph.AppendChild(comment);

 // تحتوي التعليقات على علامة "تم"، والتي يتم تعيينها على "خطأ" بشكل افتراضي.
// إذا اقترح أحد التعليقات إجراء تغيير داخل المستند،
// يمكننا تطبيق التغيير، ثم أيضًا تعيين علامة "تم" بعد ذلك للإشارة إلى التصحيح.
Assert.False(comment.Done);

doc.FirstSection.Body.FirstParagraph.Runs[0].Text = "Hello world!";
comment.Done = true;

// التعليقات التي تم "إتمامها" سوف تميز نفسها
// من تلك التي لم يتم "إنهائها" بلون نص باهت.
comment = new Comment(doc, "John Doe", "J.D.", DateTime.Now);
comment.SetText("Add text to this paragraph.");
builder.CurrentParagraph.AppendChild(comment);

doc.Save(ArtifactsDir + "Comment.Done.docx");

أنظر أيضا