Paragraph

Paragraph class

يمثل فقرة من النص .

public class Paragraph : CompositeNode

المنشئون

اسم وصف
Paragraph(DocumentBase) يقوم بتهيئة مثيل جديد لملف فقرة فئة .

الخصائص

اسم وصف
BreakIsStyleSeparator { get; } صواب إذا كان فاصل الفقرة هذا عبارة عن فاصل نمط. يسمح فاصل الأنماط بفقرة واحدة لتتكون من أجزاء لها أنماط فقرة مختلفة.
ChildNodes { get; } يحصل على جميع العقد الفرعية الفورية لهذه العقدة.
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; } صحيح إذا كانت هذه الفقرة هي الفقرة الأخيرة في ملف تذييل الرأس (قصة النص الرئيسي) من أ الجزء ؛ خطأ بخلاف ذلك.
IsEndOfSection { get; } صحيح إذا كانت هذه الفقرة هي الفقرة الأخيرة في ملف الجسم (قصة النص الرئيسي) من أ الجزء ؛ خطأ بخلاف ذلك.
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; } عوائد نوع العقدة .
ParagraphBreakFont { get; } يوفر الوصول إلى تنسيق خط حرف فاصل الفقرة.
ParagraphFormat { get; } يوفر الوصول إلى خصائص تنسيق الفقرة.
ParentNode { get; } الحصول على الأصل المباشر لهذه العقدة.
ParentSection { get; } استرداد الأصلSection من الفقرة .
ParentStory { get; } استرداد القصة الأصلية على مستوى القسم التي يمكن أن تكونBody أوHeaderFooter .
PreviousSibling { get; } يحصل على العقدة التي تسبق هذه العقدة مباشرة.
Range { get; } إرجاع أ نطاق الكائن الذي يمثل جزء المستند الموجود في هذه العقدة.
Runs { get; } يوفر الوصول إلى مجموعة أجزاء النص المكتوبة داخل الفقرة.

طُرق

اسم وصف
override Accept(DocumentVisitor) يقبل الزائر .
AppendChild(Node) يضيف العقدة المحددة إلى نهاية قائمة العقد الفرعية لهذه العقدة .
AppendField(string) لإلحاق حقل بهذه الفقرة .
AppendField(FieldType, bool) لإلحاق حقل بهذه الفقرة .
AppendField(string, string) لإلحاق حقل بهذه الفقرة .
Clone(bool) لإنشاء نسخة مكررة من العقدة .
CreateNavigator() محجوز لاستخدام النظام. IXPathNavigable.
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) تحديد العقدة الأولى التي تطابق تعبير XPath.
ToString(SaveFormat) يصدر محتوى العقدة إلى سلسلة بالتنسيق المحدد.
ToString(SaveOptions) يصدر محتوى العقدة إلى سلسلة باستخدام خيارات الحفظ المحددة.

ملاحظات

Paragraph هي عقدة على مستوى الكتلة ويمكن أن تكون تابعة للفئات المشتقة من Story أوInlineStory.

Paragraph يمكن أن يحتوي على أي عدد من العقد والإشارات المرجعية المضمنة.

تتكون القائمة الكاملة للعقد الفرعية التي يمكن أن تحدث داخل فقرة من BookmarkStart وBookmarkEnd ، FieldStart وFieldSeparator ، FieldEnd وFormField ، Comment وFootnote ، Run وSpecialChar ، Shape وGroupShape ، SmartTag.

تنتهي الفقرة الصالحة في Microsoft Word دائمًا بحرف فاصل فقرات و_ تتكون أدنى فقرة صالحة من فاصل فقرة فقط. ال فقرة تُلحق فئة تلقائيًا حرف فاصل الفقرة المناسب في end وهذا الحرف ليس جزءًا من العقد الفرعية لـ فقرة ، لذلك_ أ فقرة يمكن أن تكون فارغة.

لا تقم بتضمين نهاية الفقرةControlChar.ParagraphBreak أو نهاية الخليةControlChar.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");

أنظر أيضا