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; }True, если концевые сноски печатаются в конце следующего раздела, который не подавляет концевые сноски. Подавленные концевые сноски печатаются перед концевыми сносками в этом разделе.
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");

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