Section
محتويات
[
يخفي
]Section class
يمثل قسمًا واحدًا في مستند.
لمعرفة المزيد، قم بزيارةالعمل مع الأقسام مقالة توثيقية.
public sealed class Section : CompositeNode
المنشئون
| اسم | وصف |
|---|---|
| Section(DocumentBase) | يقوم بتهيئة مثيل جديد لفئة القسم. |
الخصائص
| اسم | وصف |
|---|---|
| Body { get; } | يعيدBody عقدة فرعية للقسم. |
| Count { get; } | يحصل على عدد الأبناء المباشرين لهذه العقدة. |
| CustomNodeId { get; set; } | يحدد معرف العقدة المخصص. |
| virtual Document { get; } | يحصل على المستند الذي تنتمي إليه هذه العقدة. |
| FirstChild { get; } | يحصل على أول طفل للعقدة. |
| HasChildNodes { get; } | إرجاعحقيقي إذا كانت هذه العقدة تحتوي على أي عقد فرعية. |
| HeadersFooters { get; } | يوفر الوصول إلى عقد الرؤوس والتذييلات الخاصة بالقسم. |
| override IsComposite { get; } | إرجاعحقيقي حيث يمكن لهذه العقدة أن تحتوي على عقد فرعية. |
| LastChild { get; } | يحصل على آخر طفل للعقدة. |
| NextSibling { get; } | يحصل على العقدة التي تلي هذه العقدة مباشرة. |
| override NodeType { get; } | إرجاعSection . |
| PageSetup { get; } | يعيد كائنًا يمثل إعداد الصفحة وخصائص القسم. |
| ParentNode { get; } | يحصل على الوالد المباشر لهذه العقدة. |
| PreviousSibling { get; } | يحصل على العقدة التي تسبق هذه العقدة مباشرةً. |
| ProtectedForForms { get; set; } | صحيح إذا كان القسم محميًا للنماذج. عند حماية القسم للنماذج، يمكن للمستخدمين تحديد وتعديل النص فقط في حقول النموذج في مايكروسوفت وورد. |
| Range { get; } | يعيدRangeالكائن الذي يمثل الجزء من المستند الموجود في هذه العقدة. |
طُرق
| اسم | وصف |
|---|---|
| override Accept(DocumentVisitor) | يقبل زائرًا. |
| override AcceptEnd(DocumentVisitor) | |
| override AcceptStart(DocumentVisitor) | |
| AppendChild<T>(T) | يضيف العقدة المحددة إلى نهاية قائمة العقد الفرعية لهذه العقدة. |
| AppendContent(Section) | يقوم بإدراج نسخة من محتوى قسم المصدر في نهاية هذا القسم. |
| ClearContent() | يمسح القسم. |
| ClearHeadersFooters() | مسح رؤوس وتذييلات هذا القسم. |
| ClearHeadersFooters(bool) | مسح رؤوس وتذييلات هذا القسم. |
| Clone() | ينشئ نسخة مكررة من هذا القسم. |
| Clone(bool) | ينشئ نسخة مكررة من العقدة. |
| CreateNavigator() | ينشئ متصفحًا يمكن استخدامه للتنقل بين العقد وقراءتها. |
| DeleteHeaderFooterShapes() | يحذف جميع الأشكال (كائنات الرسم) من رؤوس وتذييلات هذا القسم. |
| EnsureMinimum() | يتأكد من أن القسم يحتوي علىBody مع واحدParagraph . |
| 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) | يضيف العقدة المحددة إلى بداية قائمة العقد الفرعية لهذه العقدة. |
| PrependContent(Section) | يقوم بإدراج نسخة من محتوى قسم المصدر في بداية هذا القسم. |
| PreviousPreOrder(Node) | يحصل على العقدة السابقة وفقًا لخوارزمية عبور شجرة الترتيب المسبق. |
| Remove() | يزيل نفسه من الأصل. |
| RemoveAllChildren() | يزيل جميع العقد الفرعية للعقدة الحالية. |
| RemoveChild<T>(T) | يزيل العقدة الفرعية المحددة. |
| RemoveSmartTags() | يزيل الكلSmartTag العقد المنحدرة من العقدة الحالية. |
| SelectNodes(string) | يحدد قائمة العقد المطابقة لتعبير XPath. |
| SelectSingleNode(string) | يحدد الأولNode الذي يتطابق مع تعبير XPath. |
| ToString(SaveFormat) | يصدر محتوى العقدة إلى سلسلة بالتنسيق المحدد. |
| ToString(SaveOptions) | يقوم بتصدير محتوى العقدة إلى سلسلة باستخدام خيارات الحفظ المحددة. |
ملاحظات
Section يمكن أن يكون له واحدBody والحد الأقصى واحدHeaderFooter لكل منهماHeaderFooterType .Body وHeaderFooter يمكن أن يكون nodes بأي ترتيب داخلSection.
يجب أن يحتوي القسم الصحيح على الحد الأدنىBody مع واحدParagraph.
يحتوي كل قسم على مجموعة من الخصائص الخاصة به والتي تحدد حجم الصفحة والاتجاه والهوامش وما إلى ذلك.
يمكنك إنشاء نسخة من القسم باستخدامCloneيمكن إدراج النسخة في نفس المستند أو مستند مختلف.
لإضافة أو إدراج أو إزالة قسم كامل بما في ذلك فاصل القسم وخصائص القسم x000d_، استخدم طرقSections هدف.
لنسخ وإدراج محتوى القسم فقط باستثناء 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");
أنظر أيضا
- class CompositeNode
- مساحة الاسم Aspose.Words
- المجسم Aspose.Words
