Paragraph
محتويات
[
يخفي
]Paragraph class
يمثل فقرة من النص.
لمعرفة المزيد، قم بزيارةالعمل مع الفقرات مقالة توثيقية.
public class Paragraph : CompositeNode
المنشئون
| اسم | وصف |
|---|---|
| Paragraph(DocumentBase) | تهيئة مثيل جديد لـParagraph فئة. |
الخصائص
| اسم | وصف |
|---|---|
| BreakIsStyleSeparator { get; } | صحيح إذا كان فاصل الفقرة هذا عبارة عن فاصل نمط. يسمح فاصل الأنماط بأن تتكون فقرة one من أجزاء لها أنماط فقرات مختلفة. |
| Count { get; } | يحصل على عدد الأطفال المباشرين لهذه العقدة. |
| CustomNodeId { get; set; } | يحدد معرف العقدة المخصصة. |
| virtual Document { get; } | الحصول على المستند الذي تنتمي إليه هذه العقدة. |
| FirstChild { get; } | يحصل على الطفل الأول للعقدة. |
| FrameFormat { get; } | يوفر الوصول إلى خصائص تنسيق الإطار. |
| HasChildNodes { get; } | إرجاعحقيقي إذا كانت هذه العقدة تحتوي على أي عقد فرعية. |
| override IsComposite { get; } | إرجاعحقيقي لأن هذه العقدة يمكن أن تحتوي على عقد فرعية. |
| IsDeleteRevision { get; } | إرجاع صحيح إذا تم حذف هذا الكائن في Microsoft Word أثناء تمكين تعقب التغييرات. |
| IsEndOfCell { get; } | صحيح إذا كانت هذه الفقرة هي الفقرة الأخيرة في أCell ; كاذبة خلاف ذلك. |
| IsEndOfDocument { get; } | صحيح إذا كانت هذه الفقرة هي الفقرة الأخيرة في القسم الأخير من المستند. |
| IsEndOfHeaderFooter { get; } | صحيح إذا كانت هذه الفقرة هي الفقرة الأخيرة فيHeaderFooter (قصة النص الرئيسي) من أSection ; كاذبة خلاف ذلك. |
| IsEndOfSection { get; } | صحيح إذا كانت هذه الفقرة هي الفقرة الأخيرة فيBody (قصة النص الرئيسي) من أSection ; كاذبة خلاف ذلك. |
| IsFormatRevision { get; } | إرجاع صحيح إذا تم تغيير تنسيق الكائن في Microsoft Word أثناء تمكين تعقب التغييرات. |
| IsInCell { get; } | صحيح إذا كانت هذه الفقرة فرعًا مباشرًا لـCell ; كاذبة خلاف ذلك. |
| IsInsertRevision { get; } | إرجاع صحيح إذا تم إدراج هذا الكائن في Microsoft Word أثناء تمكين تعقب التغييرات. |
| IsListItem { get; } | صحيح عندما تكون الفقرة عنصرًا في قائمة ذات تعداد نقطي أو رقمي في المراجعة الأصلية. |
| IsMoveFromRevision { get; } | إرجاعحقيقي إذا تم نقل هذا الكائن (حذفه) في Microsoft Word أثناء تمكين تعقب التغييرات. |
| IsMoveToRevision { get; } | إرجاعحقيقي إذا تم نقل هذا الكائن (إدراجه) في Microsoft Word أثناء تمكين تعقب التغييرات. |
| LastChild { get; } | يحصل على الطفل الأخير للعقدة. |
| ListFormat { get; } | يوفر الوصول إلى خصائص تنسيق القائمة الخاصة بالفقرة. |
| ListLabel { get; } | يحصل علىListLabelالكائن الذي يوفر الوصول إلى قيمة ترقيم القائمة وتنسيق لهذه الفقرة. |
| NextSibling { get; } | يحصل على العقدة التي تلي هذه العقدة مباشرة. |
| override NodeType { get; } | إرجاعParagraph . |
| ParagraphBreakFont { get; } | يوفر الوصول إلى تنسيق الخط لحرف فاصل الفقرة. |
| ParagraphFormat { get; } | يوفر الوصول إلى خصائص تنسيق الفقرة. |
| ParentNode { get; } | يحصل على الأصل المباشر لهذه العقدة. |
| ParentSection { get; } | يسترد الأصلSection من الفقرة. |
| ParentStory { get; } | يسترد القصة على مستوى القسم الأصلي التي يمكن أن تكونBody أوHeaderFooter . |
| PreviousSibling { get; } | يحصل على العقدة التي تسبق هذه العقدة مباشرة. |
| Range { get; } | إرجاع أRange الكائن الذي يمثل جزء المستند الموجود في هذه العقدة. |
| Runs { get; } | يوفر الوصول إلى مجموعة أجزاء النص المكتوبة داخل الفقرة. |
طُرق
| اسم | وصف |
|---|---|
| override Accept(DocumentVisitor) | يقبل الزائر. |
| AppendChild(Node) | إضافة العقدة المحددة إلى نهاية قائمة العقد التابعة لهذه العقدة. |
| AppendField(string) | إلحاق حقل بهذه الفقرة. |
| AppendField(FieldType, bool) | إلحاق حقل بهذه الفقرة. |
| AppendField(string, string) | إلحاق حقل بهذه الفقرة. |
| Clone(bool) | إنشاء نسخة مكررة من العقدة. |
| CreateNavigator() | إنشاء متصفح يمكن استخدامه لاجتياز العقد وقراءتها. |
| GetAncestor(NodeType) | يحصل على السلف الأول للمحددNodeType . |
| GetAncestor(Type) | الحصول على السلف الأول لنوع الكائن المحدد. |
| GetChild(NodeType, int, bool) | إرجاع العقدة الفرعية N التي تطابق النوع المحدد. |
| GetChildNodes(NodeType, bool) | إرجاع مجموعة مباشرة من العقد الفرعية التي تطابق النوع المحدد. |
| GetEffectiveTabStops() | إرجاع مصفوفة من كافة علامات الجدولة المطبقة على هذه الفقرة، بما في ذلك المطبقة بشكل غير مباشر بواسطة الأنماط أو القوائم. |
| GetEnumerator() | يوفر الدعم لتكرار كل نمط عبر العقد الفرعية لهذه العقدة. |
| override GetText() | الحصول على نص هذه الفقرة بما في ذلك حرف نهاية الفقرة. |
| IndexOf(Node) | إرجاع فهرس العقدة الفرعية المحددة في صفيف العقدة الفرعية. |
| InsertAfter(Node, Node) | يقوم بإدراج العقدة المحددة مباشرة بعد العقدة المرجعية المحددة. |
| InsertBefore(Node, Node) | يقوم بإدراج العقدة المحددة مباشرة قبل العقدة المرجعية المحددة. |
| InsertField(string, Node, bool) | إدراج حقل في هذه الفقرة. |
| InsertField(FieldType, bool, Node, bool) | إدراج حقل في هذه الفقرة. |
| InsertField(string, string, Node, bool) | إدراج حقل في هذه الفقرة. |
| JoinRunsWithSameFormatting() | يتم تشغيل عمليات الانضمام بنفس التنسيق في الفقرة. |
| NextPreOrder(Node) | الحصول على العقدة التالية وفقًا لخوارزمية اجتياز شجرة الطلب المسبق. |
| PrependChild(Node) | إضافة العقدة المحددة إلى بداية قائمة العقد التابعة لهذه العقدة. |
| PreviousPreOrder(Node) | الحصول على العقدة السابقة وفقًا لخوارزمية اجتياز شجرة الطلب المسبق. |
| Remove() | يزيل نفسه من الأصل. |
| RemoveAllChildren() | إزالة جميع العقد الفرعية للعقدة الحالية. |
| RemoveChild(Node) | إزالة العقدة الفرعية المحددة. |
| RemoveSmartTags() | يزيل الكلSmartTagالعقد التابعة للعقدة الحالية. |
| SelectNodes(string) | تحديد قائمة العقد المطابقة لتعبير XPath. |
| SelectSingleNode(string) | تحديد الأولNode الذي يطابق تعبير XPath. |
| ToString(SaveFormat) | تصدير محتوى العقدة إلى سلسلة بالتنسيق المحدد. |
| ToString(SaveOptions) | تصدير محتوى العقدة إلى سلسلة باستخدام خيارات الحفظ المحددة. |
ملاحظات
Paragraph هي عقدة على مستوى الكتلة ويمكن أن تكون فرعًا للفئات المشتقة من Story أوInlineStory.
Paragraph يمكن أن تحتوي على أي عدد من العقد والإشارات المرجعية ذات المستوى المضمّن.
تتكون القائمة الكاملة للعقد الفرعية التي يمكن أن تحدث داخل الفقرة من BookmarkStart ,BookmarkEndFieldStart ,FieldSeparatorFieldEnd ,FormFieldComment ,FootnoteRun ,SpecialCharShape ,GroupShapeSmartTag.
تنتهي الفقرة الصالحة في Microsoft Word دائمًا بحرف فاصل فقرة و وتتكون الفقرة الصحيحة الدنيا من فاصل فقرة فقط. الParagraph تقوم فئة تلقائيًا بإلحاق حرف فاصل الفقرة المناسب في end وهذا الحرف ليس جزءًا من العقد الفرعية للParagraph ، وبالتالي أParagraph يمكن أن تكون فارغة.
لا تقم بتضمين نهاية الفقرةParagraphBreak أو نهاية الخليةCell الأحرف الموجودة داخل نص الفقرة لأنها قد تجعل الفقرة غير صالحة عند فتح المستند في Microsoft Word.
أمثلة
يوضح كيفية إنشاء مستند Aspose.Words يدويًا.
Document doc = new Document();
// يحتوي المستند الفارغ على قسم واحد ونص واحد وفقرة واحدة.
// اتصل بالطريقة "RemoveAllChildren" لإزالة كل تلك العقد،
// وينتهي الأمر بعقدة مستند بدون أطفال.
doc.RemoveAllChildren();
// لا يحتوي هذا المستند الآن على عقد فرعية مركبة يمكننا إضافة محتوى إليها.
// إذا أردنا تعديله، فسنحتاج إلى إعادة ملء مجموعة العقد الخاصة به.
// أولاً، قم بإنشاء قسم جديد، ثم قم بإلحاقه كفرع لعقدة المستند الجذر.
Section section = new Section(doc);
doc.AppendChild(section);
// قم بتعيين بعض خصائص إعداد الصفحة للقسم.
section.PageSetup.SectionStart = SectionStart.NewPage;
section.PageSetup.PaperSize = PaperSize.Letter;
// يحتاج القسم إلى نص يحتوي على جميع محتوياته ويعرضها
// في الصفحة الواقعة بين رأس القسم وتذييله.
Body body = new Body(doc);
section.AppendChild(body);
// أنشئ فقرة، وعيّن بعض خصائص التنسيق، ثم ألحقها كطفل فرعي بالنص.
Paragraph para = new Paragraph(doc);
para.ParagraphFormat.StyleName = "Heading 1";
para.ParagraphFormat.Alignment = ParagraphAlignment.Center;
body.AppendChild(para);
// وأخيرًا، أضف بعض المحتوى لإجراء المستند. إنشاء تشغيل،
// اضبط مظهرها ومحتوياتها، ثم ألحقها كطفل للفقرة.
Run run = new Run(doc);
run.Text = "Hello World!";
run.Font.Color = Color.Red;
para.AppendChild(run);
Assert.AreEqual("Hello World!", doc.GetText().Trim());
doc.Save(ArtifactsDir + "Section.CreateManually.docx");
أنظر أيضا
- class CompositeNode
- مساحة الاسم Aspose.Words
- المجسم Aspose.Words
