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; }True, если на первой странице используется другой верхний или нижний колонтитул.
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");

Смотрите также