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; }يحصل على طريقة تشغيل ترقيم الأسطر أو يحددها، أي ما إذا كان يبدأ من جديد في بداية صفحة أو قسم جديد أو يعمل بشكل مستمر.
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");

أنظر أيضا