PageSetup

PageSetup class

يمثل خصائص إعداد الصفحة لقسم ما.

لمعرفة المزيد، قم بزيارةالعمل مع الأقسام مقالة توثيقية.

public class PageSetup

الخصائص

اسموصف
Bidi { get; set; }يحدد أن هذا القسم يحتوي على نص ثنائي الاتجاه (برامج نصية معقدة).
BorderAlwaysInFront { get; set; }يحدد مكان وضع حدود الصفحة بالنسبة للنصوص والكائنات المتقاطعة.
BorderAppliesTo { get; set; }يحدد الصفحات التي سيتم طباعة حدود الصفحة عليها.
BorderDistanceFrom { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كان حد الصفحة المحدد يتم قياسه من حافة الصفحة أو من النص المحيط بها.
Borders { get; }الحصول على مجموعة من حدود الصفحة.
BorderSurroundsFooter { get; set; }يحدد ما إذا كان حد الصفحة يتضمن التذييل أم لا.
BorderSurroundsHeader { get; set; }يحدد ما إذا كانت حدود الصفحة تتضمن الرأس أم لا.
BottomMargin { get; set; }إرجاع أو تعيين المسافة (بالنقاط) بين الحافة السفلية للصفحة والحد السفلي للنص الأساسي.
ChapterPageSeparator { get; set; }الحصول على أو تعيين الحرف الفاصل الذي يظهر بين رقم الفصل ورقم الصفحة.
CharactersPerLine { get; set; }الحصول على أو تعيين عدد الأحرف لكل سطر في شبكة المستند.
DifferentFirstPageHeaderFooter { get; set; }صحيح إذا تم استخدام رأس أو تذييل مختلف في الصفحة الأولى.
EndnoteOptions { get; }يوفر خيارات تتحكم في ترقيم التعليقات الختامية وموضعها في هذا القسم.
FirstPageTray { get; set; }الحصول على أو تعيين درج الورق (الحاوية) لاستخدامه في الصفحة الأولى من القسم. القيمة خاصة بالتنفيذ (الطابعة).
FooterDistance { get; set; }إرجاع أو تعيين المسافة (بالنقاط) بين التذييل وأسفل الصفحة.
FootnoteOptions { get; }يوفر خيارات تتحكم في ترقيم الحواشي السفلية وموضعها في هذا القسم.
Gutter { get; set; }الحصول على أو تعيين مقدار المساحة الإضافية المضافة إلى هامش ربط المستند.
HeaderDistance { get; set; }إرجاع أو تعيين المسافة (بالنقاط) بين الرأس وأعلى الصفحة.
HeadingLevelForChapter { get; set; }الحصول على أو تعيين نمط مستوى العنوان الذي يتم تطبيقه على عناوين الفصول في المستند.
LayoutMode { get; set; }الحصول على أو تعيين وضع التخطيط لهذا القسم.
LeftMargin { get; set; }إرجاع أو تعيين المسافة (بالنقاط) بين الحافة اليسرى للصفحة والحد الأيسر للنص الأساسي.
LineNumberCountBy { get; set; }إرجاع أو تعيين الزيادة الرقمية لأرقام الأسطر.
LineNumberDistanceFromText { get; set; }الحصول على أو تعيين المسافة بين الحافة اليمنى لأرقام الأسطر والحافة اليسرى للمستند.
LineNumberRestartMode { get; set; }الحصول على أو تعيين الطريقة التي يتم بها تشغيل ترقيم الأسطر، سواء كان يبدأ من جديد في بداية صفحة أو قسم new أو يتم تشغيله بشكل مستمر.
LinesPerPage { get; set; }الحصول على أو تعيين عدد الأسطر لكل صفحة في شبكة المستند.
LineStartingNumber { get; set; }الحصول على رقم سطر البداية أو تعيينه.
Margins { get; set; }إرجاع أو ضبط الإعداد المسبقMargins من الصفحة.
MultiplePages { get; set; }بالنسبة للمستندات ذات الصفحات المتعددة، يتم الحصول على أو تعيين كيفية طباعة المستند أو عرضه بحيث يمكن ربطه ككتيب.
OddAndEvenPagesHeaderFooter { get; set; }صحيح إذا كان المستند يحتوي على رؤوس وتذييلات مختلفة للصفحات ذات الأرقام الفردية والزوجية.
Orientation { get; set; }إرجاع أو تعيين اتجاه الصفحة.
OtherPagesTray { get; set; }الحصول على أو تعيين درج الورق (الحاوية) ليتم استخدامه للجميع باستثناء الصفحة الأولى من القسم. القيمة خاصة بالتنفيذ (الطابعة).
PageHeight { get; set; }إرجاع أو تعيين ارتفاع الصفحة بالنقاط.
PageNumberStyle { get; set; }الحصول على تنسيق رقم الصفحة أو تعيينه.
PageStartingNumber { get; set; }الحصول على أو تعيين رقم صفحة البداية للقسم.
PageWidth { get; set; }إرجاع أو تعيين عرض الصفحة بالنقاط.
PaperSize { get; set; }إرجاع حجم الورق أو تعيينه.
RestartPageNumbering { get; set; }صحيح إذا تم إعادة تشغيل ترقيم الصفحات في بداية القسم.
RightMargin { get; set; }إرجاع أو تعيين المسافة (بالنقاط) بين الحافة اليمنى للصفحة والحد الأيمن للنص الأساسي.
RtlGutter { get; set; }الحصول على أو تعيين ما إذا كان Microsoft Word يستخدم المزاريب للقسم بناءً على لغة من اليمين إلى اليسار أو لغة من اليسار إلى اليمين.
SectionStart { get; set; }إرجاع أو تعيين نوع الفاصل المقطعي للكائن المحدد.
SheetsPerBooklet { get; set; }إرجاع أو تعيين عدد الصفحات التي سيتم تضمينها في كل كتيب.
SuppressEndnotes { get; set; }صحيح إذا تمت طباعة التعليقات الختامية في نهاية القسم التالي، وهذا لا يمنع التعليقات الختامية. تتم طباعة التعليقات الختامية المحذوفة قبل التعليقات الختامية في هذا القسم.
TextColumns { get; }إرجاع مجموعة تمثل مجموعة أعمدة النص.
TextOrientation { get; set; }يسمح بالتحديدTextOrientation للصفحة بأكملها. القيمة الافتراضية هيHorizontal
TopMargin { get; set; }إرجاع أو تعيين المسافة (بالنقاط) بين الحافة العلوية للصفحة والحد العلوي للنص الأساسي.
VerticalAlignment { get; set; }إرجاع أو تعيين المحاذاة الرأسية للنص في كل صفحة في مستند أو قسم.

طُرق

اسموصف
ClearFormatting()إعادة ضبط إعداد الصفحة على حجم الورق والهوامش والاتجاه الافتراضي.

ملاحظات

PageSetup يحتوي الكائن على كافة سمات إعداد الصفحة الخاصة بـ section (الهامش الأيسر، والهامش السفلي، وحجم الورق، وما إلى ذلك) كخصائص.

أمثلة

يوضح كيفية تطبيق إعدادات إعداد الصفحة وإعادتها إلى الأقسام الموجودة في المستند.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// تعديل خصائص إعداد الصفحة للقسم الحالي للمنشئ وإضافة نص.
builder.PageSetup.Orientation = Orientation.Landscape;
builder.PageSetup.VerticalAlignment = PageVerticalAlignment.Center;
builder.Writeln("This is the first section, which landscape oriented with vertically centered text.");

// إذا بدأنا قسمًا جديدًا باستخدام أداة إنشاء المستندات،
// سوف يرث خصائص إعداد الصفحة الحالية للمنشئ.
builder.InsertBreak(BreakType.SectionBreakNewPage);

Assert.AreEqual(Orientation.Landscape, doc.Sections[1].PageSetup.Orientation);
Assert.AreEqual(PageVerticalAlignment.Center, doc.Sections[1].PageSetup.VerticalAlignment);

// يمكننا إعادة خصائص إعداد الصفحة إلى قيمها الافتراضية باستخدام طريقة "ClearFormatting".
builder.PageSetup.ClearFormatting();

Assert.AreEqual(Orientation.Portrait, doc.Sections[1].PageSetup.Orientation);
Assert.AreEqual(PageVerticalAlignment.Top, doc.Sections[1].PageSetup.VerticalAlignment);

builder.Writeln("This is the second section, which is in default Letter paper size, portrait orientation and top alignment.");

doc.Save(ArtifactsDir + "PageSetup.ClearFormatting.docx");

أنظر أيضا