Paragraph
Paragraph class
يمثل فقرة من النص.
لمعرفة المزيد، قم بزيارةالعمل مع الفقرات مقالة توثيقية.
public class Paragraph : CompositeNode
المنشئون
اسم | وصف |
---|---|
Paragraph(DocumentBase) | يقوم بتهيئة مثيل جديد لـParagraph الصف. |
الخصائص
اسم | وصف |
---|---|
BreakIsStyleSeparator { 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; } | صحيح إذا كانت هذه الفقرة هي الفقرة الأخيرة في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) | يقبل زائرًا. |
override AcceptEnd(DocumentVisitor) | يقبل الزائر لزيارة نهاية فقرة المستند. |
override AcceptStart(DocumentVisitor) | يقبل الزائر لزيارة بداية فقرة المستند. |
AppendChild<T>(T) | يضيف العقدة المحددة إلى نهاية قائمة العقد الفرعية لهذه العقدة. |
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<T>(T, Node) | يقوم بإدراج العقدة المحددة فورًا بعد عقدة المرجع المحددة. |
InsertBefore<T>(T, Node) | يقوم بإدراج العقدة المحددة مباشرة قبل عقدة المرجع المحددة. |
InsertField(string, Node, bool) | يُدرج حقلاً في هذه الفقرة. |
InsertField(FieldType, bool, Node, bool) | يُدرج حقلاً في هذه الفقرة. |
InsertField(string, string, Node, bool) | يُدرج حقلاً في هذه الفقرة. |
JoinRunsWithSameFormatting() | ينضم إلى التشغيلات بنفس التنسيق في الفقرة. |
NextPreOrder(Node) | يحصل على العقدة التالية وفقًا لخوارزمية عبور شجرة الترتيب المسبق. |
PrependChild<T>(T) | يضيف العقدة المحددة إلى بداية قائمة العقد الفرعية لهذه العقدة. |
PreviousPreOrder(Node) | يحصل على العقدة السابقة وفقًا لخوارزمية عبور شجرة الترتيب المسبق. |
Remove() | يزيل نفسه من الأصل. |
RemoveAllChildren() | يزيل جميع العقد الفرعية للعقدة الحالية. |
RemoveChild<T>(T) | يزيل العقدة الفرعية المحددة. |
RemoveSmartTags() | يزيل الكلSmartTag العقد المنحدرة من العقدة الحالية. |
SelectNodes(string) | يحدد قائمة العقد المطابقة لتعبير XPath. |
SelectSingleNode(string) | يحدد الأولNode الذي يتطابق مع تعبير XPath. |
ToString(SaveFormat) | يصدر محتوى العقدة إلى سلسلة بالتنسيق المحدد. |
ToString(SaveOptions) | يقوم بتصدير محتوى العقدة إلى سلسلة باستخدام خيارات الحفظ المحددة. |
ملاحظات
Paragraph
هي عقدة على مستوى الكتلة ويمكن أن تكون طفلة للفئات المشتقة من Story
أوInlineStory
.
Paragraph
يمكن أن يحتوي على أي عدد من العقد والإشارات المرجعية على المستوى المضمن.
تتكون القائمة الكاملة للعقد الفرعية التي يمكن أن تظهر داخل فقرة من BookmarkStart
،BookmarkEnd
، FieldStart
،FieldSeparator
، FieldEnd
،FormField
، Comment
،Footnote
، Run
،SpecialChar
، Shape
،GroupShape
، SmartTag
.
تنتهي الفقرة الصحيحة في Microsoft Word دائمًا بفاصل فقرة، وتتكون الفقرة الصحيحة الدنيا من فاصل فقرة فقط.Paragraph
تضيف فئة تلقائيًا حرف فاصل الفقرة المناسب في نهاية وهذا الحرف ليس جزءًا من العقد الفرعية لـ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