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; } | يحصل على التاريخ والوقت الذي تم فيه تقديم التعليق. |
| DateTimeUtc { get; } | يحصل على تاريخ ووقت UTC الذي تم فيه تقديم التعليق. |
| virtual Document { get; } | يحصل على المستند الذي تنتمي إليه هذه العقدة. |
| Done { get; set; } | يحصل على أو يعين علامة تشير إلى أن التعليق تم وضع علامة عليه بأنه تم الانتهاء منه. |
| FirstChild { get; } | يحصل على أول طفل للعقدة. |
| FirstParagraph { get; } | يحصل على الفقرة الأولى في القصة. |
| Font { get; } | يوفر الوصول إلى تنسيق الخط لحرف المرساة لهذا الكائن. |
| HasChildNodes { get; } | إرجاعحقيقي إذا كانت هذه العقدة تحتوي على أي عقد فرعية. |
| Id { get; set; } | يحصل على معرف التعليق أو يعينه. |
| 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; } | يحصل على مجموعة من الفقرات التي تعتبر أبناءً مباشرين للقصة. |
| ParentId { get; set; } | يحصل على معرف التعليق الرئيسي أو يعينه. قيمة-1 يعني أن التعليق ليس له أصل. |
| ParentNode { get; } | يحصل على الوالد المباشر لهذه العقدة. |
| ParentParagraph { get; } | يسترد الأصلParagraph من هذه العقدة. |
| PreviousSibling { get; } | يحصل على العقدة التي تسبق هذه العقدة مباشرةً. |
| Range { get; } | يعيدRangeالكائن الذي يمثل الجزء من المستند الموجود في هذه العقدة. |
| Replies { get; } | يعيد مجموعة منComment الكائنات التي تعتبر أبناءً مباشرين للتعليق المحدد. |
| override StoryType { get; } | إرجاعComments . |
| Tables { get; } | يحصل على مجموعة من الجداول التي تعتبر أبناءًا مباشرين للقصة. |
طُرق
| اسم | وصف |
|---|---|
| override Accept(DocumentVisitor) | يقبل زائرًا. |
| override AcceptEnd(DocumentVisitor) | يقبل الزائر لزيارة نهاية التعليق. |
| override AcceptStart(DocumentVisitor) | يقبل الزائر لزيارة بداية التعليق. |
| AddReply(string, string, DateTime, string) | يضيف ردًا على هذا التعليق. |
| AppendChild<T>(T) | يضيف العقدة المحددة إلى نهاية قائمة العقد الفرعية لهذه العقدة. |
| Clone(bool) | ينشئ نسخة مكررة من العقدة. |
| CreateNavigator() | ينشئ متصفحًا يمكن استخدامه للتنقل بين العقد وقراءتها. |
| EnsureMinimum() | إذا لم يكن الطفل الأخير فقرة، يتم إنشاء فقرة فارغة وإضافتها. |
| GetAncestor(NodeType) | يحصل على السلف الأول للعنصر المحددNodeType . |
| GetAncestor(Type) | يحصل على السلف الأول لنوع الكائن المحدد. |
| GetChild(NodeType, int, bool) | يعيد عقدة فرعية رقم N تطابق النوع المحدد. |
| GetChildNodes(NodeType, bool) | يعيد مجموعة حية من العقد الفرعية التي تطابق النوع المحدد. |
| GetEnumerator() | يوفر الدعم لكل تكرار للأسلوب على العقد الفرعية لهذه العقدة. |
| override GetText() | يحصل على نص هذه العقدة وجميع أبنائها. |
| IndexOf(Node) | يعيد مؤشر العقدة الفرعية المحددة في مجموعة العقد الفرعية. |
| InsertAfter<T>(T, Node) | يقوم بإدراج العقدة المحددة فورًا بعد عقدة المرجع المحددة. |
| InsertBefore<T>(T, Node) | يقوم بإدراج العقدة المحددة مباشرة قبل عقدة المرجع المحددة. |
| NextPreOrder(Node) | يحصل على العقدة التالية وفقًا لخوارزمية عبور شجرة الترتيب المسبق. |
| PrependChild<T>(T) | يضيف العقدة المحددة إلى بداية قائمة العقد الفرعية لهذه العقدة. |
| PreviousPreOrder(Node) | يحصل على العقدة السابقة وفقًا لخوارزمية عبور شجرة الترتيب المسبق. |
| Remove() | يزيل نفسه من الأصل. |
| RemoveAllChildren() | يزيل جميع العقد الفرعية للعقدة الحالية. |
| RemoveAllReplies() | يزيل جميع الردود على هذا التعليق. |
| RemoveChild<T>(T) | يزيل العقدة الفرعية المحددة. |
| RemoveReply(Comment) | يزيل الرد المحدد على هذا التعليق. |
| RemoveSmartTags() | يزيل الكلSmartTag العقد المنحدرة من العقدة الحالية. |
| SelectNodes(string) | يحدد قائمة العقد المطابقة لتعبير XPath. |
| SelectSingleNode(string) | يحدد الأولNode الذي يتطابق مع تعبير XPath. |
| SetText(string) | هذه طريقة ملائمة تسمح لك بتعيين نص التعليق بسهولة. |
| ToString(SaveFormat) | يصدر محتوى العقدة إلى سلسلة بالتنسيق المحدد. |
| ToString(SaveOptions) | يقوم بتصدير محتوى العقدة إلى سلسلة باستخدام خيارات الحفظ المحددة. |
ملاحظات
التعليق هو عبارة عن توضيح مرتبط بمنطقة من النص أو بموضع في النص. يمكن أن يحتوي التعليق على كمية عشوائية من المحتوى على مستوى الكتلة.
إذا كانComment إذا حدث الكائن من تلقاء نفسه، يتم تثبيت التعليق على موضع x000d_Comment هدف.
لتثبيت تعليق على منطقة من النص، هناك حاجة إلى ثلاثة كائنات:Comment ، CommentRangeStart و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");
أنظر أيضا
- class InlineStory
- مساحة الاسم Aspose.Words
- المجسم Aspose.Words
