Section

Section class

يمثل قسمًا واحدًا في مستند.

public sealed class Section : CompositeNode

المنشئون

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

الخصائص

اسم وصف
Body { get; } إرجاع ملف الجسم العقدة الفرعية للقسم.
ChildNodes { get; } يحصل على جميع العقد الفرعية الفورية لهذه العقدة.
Count { get; } الحصول على عدد الأطفال المباشرين لهذه العقدة.
CustomNodeId { get; set; } يحدد معرف العقدة المخصص .
virtual Document { get; } الحصول على المستند الذي تنتمي إليه هذه العقدة .
FirstChild { get; } الحصول على الطفل الأول للعقدة .
HasChildNodes { get; } إرجاع صحيح إذا كانت هذه العقدة بها أي عقد فرعية.
HeadersFooters { get; } يوفر الوصول إلى رؤوس وتذييلات العقد الخاصة بالقسم.
override IsComposite { get; } إرجاع صحيح لأن هذه العقدة يمكن أن تحتوي على عقد فرعية.
LastChild { get; } الحصول على آخر تابع للعقدة .
NextSibling { get; } يحصل على العقدة التي تلي هذه العقدة مباشرة.
override NodeType { get; } عوائد نوع العقدة .
PageSetup { get; } إرجاع كائن يمثل إعداد الصفحة وخصائص القسم.
ParentNode { get; } الحصول على الأصل المباشر لهذه العقدة.
PreviousSibling { get; } يحصل على العقدة التي تسبق هذه العقدة مباشرة.
ProtectedForForms { get; set; } صواب إذا كان القسم محميًا للنماذج. عندما يكون القسم محميًا للنماذج ، يمكن للمستخدمين تحديد النص وتعديله فقط في حقول النموذج في Microsoft Word .
Range { get; } إرجاع أ نطاق الكائن الذي يمثل جزء المستند الموجود في هذه العقدة.

طُرق

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

ملاحظات

الجزء يمكن أن يكون واحدBody واحد كحد أقصىHeaderFooter لكل منهماHeaderFooterType . الجسم و تذييل الرأس يمكن أن يكون nodes بأي ترتيب بالداخل الجزء.

الحد الأدنى من القسم الصالح يحتاج إلى الجسم مع واحد فقرة.

يحتوي كل قسم على مجموعة الخصائص الخاصة به التي تحدد حجم الصفحة والاتجاه والهوامش وما إلى ذلك.

يمكنك إنشاء نسخة من قسم باستخدامClone. يمكن إدراج النسخة في نفس المستند أو في مستند مختلف.

لإضافة أو إدراج أو إزالة قسم كامل بما في ذلك فاصل المقطع وخصائص القسم استخدم طرق الأقسام هدف.

لنسخ وإدراج محتوى القسم فقط باستثناء المقطع break واستخدام خصائص القسم AppendContent و PrependContentطُرق.

أمثلة

يوضح كيفية إنشاء مستند 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");

أنظر أيضا