Comment

Comment class

يمثل حاوية لنص التعليق.

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

public sealed class Comment : InlineStory

المنشئون

اسموصف
Comment(DocumentBase)تهيئة مثيل جديد لـComment فئة.
Comment(DocumentBase, string, string, DateTime)تهيئة مثيل جديد لـComment فئة.

الخصائص

اسموصف
Ancestor { get; }إرجاع الأصلComment هدف. عائداتباطل للحصول على تعليقات عالية المستوى.
Author { get; set; }إرجاع أو تعيين اسم المؤلف للتعليق.
Count { get; }يحصل على عدد الأطفال المباشرين لهذه العقدة.
CustomNodeId { get; set; }يحدد معرف العقدة المخصصة.
DateTime { get; set; }الحصول على تاريخ ووقت كتابة التعليق.
virtual Document { get; }الحصول على المستند الذي تنتمي إليه هذه العقدة.
Done { get; set; }الحصول على أو تعيين علامة تشير إلى أنه تم وضع علامة “تم” على التعليق.
FirstChild { get; }يحصل على الطفل الأول للعقدة.
FirstParagraph { get; }الحصول على الفقرة الأولى في القصة.
Font { get; }يوفر الوصول إلى تنسيق الخط لحرف الربط لهذا الكائن.
HasChildNodes { get; }إرجاعحقيقي إذا كانت هذه العقدة تحتوي على أي عقد فرعية.
Id { get; }الحصول على معرف التعليق.
Initial { get; set; }إرجاع أو تعيين الأحرف الأولى من اسم المستخدم المرتبط بتعليق معين.
override IsComposite { get; }إرجاعحقيقي لأن هذه العقدة يمكن أن تحتوي على عقد فرعية.
IsDeleteRevision { get; }إرجاع صحيح إذا تم حذف هذا الكائن في Microsoft Word أثناء تمكين تعقب التغييرات.
IsInsertRevision { get; }إرجاع صحيح إذا تم إدراج هذا الكائن في Microsoft Word أثناء تمكين تعقب التغييرات.
IsMoveFromRevision { get; }إرجاعحقيقي إذا تم نقل هذا الكائن (حذفه) في Microsoft Word أثناء تمكين تعقب التغييرات.
IsMoveToRevision { get; }إرجاعحقيقي إذا تم نقل هذا الكائن (إدراجه) في Microsoft Word أثناء تمكين تعقب التغييرات.
LastChild { get; }يحصل على الطفل الأخير للعقدة.
LastParagraph { get; }الحصول على الفقرة الأخيرة في القصة.
NextSibling { get; }يحصل على العقدة التي تلي هذه العقدة مباشرة.
override NodeType { get; }إرجاعComment .
Paragraphs { get; }يحصل على مجموعة من الفقرات التي تعتبر أبناء القصة مباشرة.
ParentNode { get; }يحصل على الأصل المباشر لهذه العقدة.
ParentParagraph { get; }يسترد الأصلParagraph من هذه العقدة.
PreviousSibling { get; }يحصل على العقدة التي تسبق هذه العقدة مباشرة.
Range { get; }إرجاع أRange الكائن الذي يمثل جزء المستند الموجود في هذه العقدة.
Replies { get; }إرجاع مجموعة منComment الكائنات التي تعتبر أبناء مباشرين للتعليق المحدد.
override StoryType { get; }إرجاعComments .
Tables { get; }الحصول على مجموعة من الجداول التي تعتبر أبناء القصة مباشرة.

طُرق

اسموصف
override Accept(DocumentVisitor)يقبل الزائر.
AddReply(string, string, DateTime, string)إضافة رد على هذا التعليق.
AppendChild(Node)إضافة العقدة المحددة إلى نهاية قائمة العقد التابعة لهذه العقدة.
Clone(bool)إنشاء نسخة مكررة من العقدة.
CreateNavigator()إنشاء متصفح يمكن استخدامه لاجتياز العقد وقراءتها.
EnsureMinimum()إذا لم يكن العنصر الفرعي الأخير فقرة، فسيتم إنشاء فقرة واحدة فارغة وإلحاقها.
GetAncestor(NodeType)يحصل على السلف الأول للمحددNodeType .
GetAncestor(Type)الحصول على السلف الأول لنوع الكائن المحدد.
GetChild(NodeType, int, bool)إرجاع العقدة الفرعية N التي تطابق النوع المحدد.
GetChildNodes(NodeType, bool)إرجاع مجموعة مباشرة من العقد الفرعية التي تطابق النوع المحدد.
GetEnumerator()يوفر الدعم لتكرار كل نمط عبر العقد الفرعية لهذه العقدة.
override GetText()الحصول على نص هذه العقدة وجميع أبنائها.
IndexOf(Node)إرجاع فهرس العقدة الفرعية المحددة في صفيف العقدة الفرعية.
InsertAfter(NodeNode)يقوم بإدراج العقدة المحددة مباشرة بعد العقدة المرجعية المحددة.
InsertBefore(NodeNode)يقوم بإدراج العقدة المحددة مباشرة قبل العقدة المرجعية المحددة.
NextPreOrder(Node)الحصول على العقدة التالية وفقًا لخوارزمية اجتياز شجرة الطلب المسبق.
PrependChild(Node)إضافة العقدة المحددة إلى بداية قائمة العقد التابعة لهذه العقدة.
PreviousPreOrder(Node)الحصول على العقدة السابقة وفقًا لخوارزمية اجتياز شجرة الطلب المسبق.
Remove()يزيل نفسه من الأصل.
RemoveAllChildren()إزالة جميع العقد الفرعية للعقدة الحالية.
RemoveAllReplies()يزيل كافة الردود على هذا التعليق.
RemoveChild(Node)إزالة العقدة الفرعية المحددة.
RemoveReply(Comment)إزالة الرد المحدد على هذا التعليق.
RemoveSmartTags()يزيل الكلSmartTagالعقد التابعة للعقدة الحالية.
SelectNodes(string)تحديد قائمة العقد المطابقة لتعبير XPath.
SelectSingleNode(string)تحديد الأولNode الذي يطابق تعبير XPath.
SetText(string)هذه طريقة ملائمة تتيح لك ضبط نص التعليق بسهولة.
ToString(SaveFormat)تصدير محتوى العقدة إلى سلسلة بالتنسيق المحدد.
ToString(SaveOptions)تصدير محتوى العقدة إلى سلسلة باستخدام خيارات الحفظ المحددة.

ملاحظات

التعليق عبارة عن تعليق توضيحي يتم تثبيته على منطقة من النص أو على موضع في النص. يمكن أن يحتوي التعليق على قدر عشوائي من المحتوى على مستوى الكتلة.

اذا كانComment يحدث الكائن من تلقاء نفسه، ويتم تثبيت التعليق على موضع الملفComment هدف.

لربط تعليق بمنطقة نصية، يلزم وجود ثلاثة كائنات:CommentCommentRangeStart وCommentRangeEnd . تحتاج الكائنات الثلاثة إلى مشاركة نفس الشيء Id قيمة.

Comment هي عقدة ذات مستوى مضمّن ويمكن أن تكون فرعًا فقط لـParagraph.

Comment يمكن أن تحتويParagraph وTable العقد الفرعية.

أمثلة

يوضح كيفية إضافة تعليق إلى فقرة.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Write("Hello world!");

Comment comment = new Comment(doc, "John Doe", "JD", DateTime.Today);
builder.CurrentParagraph.AppendChild(comment);
builder.MoveTo(comment.AppendChild(new Paragraph(doc)));
builder.Write("Comment text.");

Assert.AreEqual(DateTime.Today, comment.DateTime);

 // في Microsoft Word، يمكننا النقر بزر الماوس الأيمن فوق هذا التعليق في نص المستند لتحريره أو الرد عليه.
doc.Save(ArtifactsDir + "InlineStory.AddComment.docx");

يوضح كيفية إضافة تعليق إلى مستند، ثم الرد عليه.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Comment comment = new Comment(doc, "John Doe", "J.D.", DateTime.Now);
comment.SetText("My comment.");

// ضع التعليق على عقدة في نص المستند.
// سيظهر هذا التعليق في مكان فقرته،
// خارج الهامش الأيمن للصفحة، وبخط منقط يصلها بالفقرة الخاصة بها.
builder.CurrentParagraph.AppendChild(comment);

// أضف ردًا، والذي سيظهر أسفل التعليق الأصلي.
comment.AddReply("Joe Bloggs", "J.B.", DateTime.Now, "New reply");

// التعليقات والردود كلاهما عقد تعليق.
Assert.AreEqual(2, doc.GetChildNodes(NodeType.Comment, true).Count);

// التعليقات التي لا ترد على التعليقات الأخرى هي "المستوى الأعلى". ليس لديهم تعليقات الأجداد.
Assert.Null(comment.Ancestor);

// الردود لها تعليق من المستوى الأعلى للأسلاف.
Assert.AreEqual(comment, comment.Replies[0].Ancestor);

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

أنظر أيضا