Класс Aspose::Words::PageSetup

PageSetup class

Представляет свойства настройки страницы секции. Чтобы узнать больше, посетите статью документации Working with Sections.

class PageSetup : public Aspose::Words::IBorderAttrSource

Методы

МетодОписание
ClearFormatting()Сбрасывает настройки страницы к размерам бумаги, полям и ориентации по умолчанию.
get_Bidi()Указывает, что этот раздел содержит двунаправленный (сложные скрипты) текст.
get_BorderAlwaysInFront()Указывает, где граница страницы расположена относительно пересекающихся текстов и объектов.
get_BorderAppliesTo()Указывает, на каких страницах печатается граница страницы.
get_BorderDistanceFrom()Получает или задает значение, указывающее, измеряется ли указанная граница страницы от края страницы или от окружающего её текста.
get_Borders()Получает коллекцию границ страницы.
get_BorderSurroundsFooter()Указывает, включает ли граница страницы нижний колонтитул или исключает его.
get_BorderSurroundsHeader()Указывает, включает ли граница страницы верхний колонтитул или исключает его.
get_BottomMargin()Возвращает или задает расстояние (в пунктах) между нижним краем страницы и нижней границей основного текста.
get_ChapterPageSeparator()Получает или задает символ-разделитель, который появляется между номером главы и номером страницы.
get_CharactersPerLine()Получает или задает количество символов в строке сетки документа.
get_DifferentFirstPageHeaderFooter()Истина, если на первой странице используется другой верхний или нижний колонтитул.
get_EndnoteOptions()Предоставляет параметры, которые управляют нумерацией и расположением концевых сносок в этом разделе.
get_FirstPageTray()Получает лоток (контейнер) бумаги, используемый для первой страницы раздела. Значение зависит от реализации (принтера).
get_FooterDistance()Возвращает или задает расстояние (в пунктах) между нижним колонтитулом и нижней границей страницы.
get_FootnoteOptions()Предоставляет параметры, которые управляют нумерацией и расположением сносок в этом разделе.
get_Gutter()Получает или задает количество дополнительного пространства, добавляемого к полю для переплёта документа.
get_HeaderDistance()Возвращает или задает расстояние (в пунктах) между верхним колонтитулом и верхней границей страницы.
get_HeadingLevelForChapter()Получает или задает стиль уровня заголовка, применяемый к названиям глав в документе.
get_LayoutMode()Получает или задает режим макета этого раздела.
get_LeftMargin()Возвращает или задает расстояние (в пунктах) между левым краем страницы и левой границей основного текста.
get_LineNumberCountBy()Возвращает или задает числовой шаг для номеров строк.
get_LineNumberDistanceFromText()Получает или задает расстояние между правым краем номеров строк и левым краем документа.
get_LineNumberRestartMode()Получает или задает способ нумерации строк, то есть начинается ли она заново в начале новой страницы или раздела, или продолжается непрерывно.
get_LinesPerPage()Получает или задает количество строк на страницу в сетке документа.
get_LineStartingNumber()Получает или задает начальный номер строки.
get_Margins()Возвращает или задает предустановленные Margins страницы.
get_MultiplePages() constДля многостраничных документов получает или задает способ печати или отображения документа, чтобы его можно было собрать в виде брошюры.
get_OddAndEvenPagesHeaderFooter() constИстина, если документ имеет разные верхние и нижние колонтитулы для нечётных и чётных страниц.
get_Orientation()Возвращает или задает ориентацию страницы.
get_OtherPagesTray()Получает лоток (контейнер) бумаги, используемый для всех страниц, кроме первой, раздела. Значение зависит от реализации (принтера).
get_PageHeight()Возвращает или задает высоту страницы в пунктах.
get_PageNumberStyle()Получает или задает формат номера страницы.
get_PageStartingNumber()Получает или задает начальный номер страницы раздела.
get_PageWidth()Возвращает или задает ширину страницы в пунктах.
get_PaperSize()Возвращает или задает размер бумаги.
get_RestartPageNumbering()True, если нумерация страниц начинается заново в начале раздела.
get_RightMargin()Возвращает или задает расстояние (в пунктах) между правым краем страницы и правой границей основного текста.
get_RtlGutter()Получает или задает, использует ли Microsoft Word отступы (gutter) для раздела в зависимости от языка с направлением справа налево или слева направо.
get_SectionStart()Возвращает или задает тип разрыва раздела для указанного объекта.
get_SheetsPerBooklet() constВозвращает или задает количество страниц, включаемых в каждый буклет.
get_SuppressEndnotes()True, если сноски печатаются в конце следующего раздела, который не подавляет сноски. Подавленные сноски печатаются перед сносками в этом разделе.
get_TextColumns()Возвращает коллекцию, представляющую набор текстовых колонок.
get_TextOrientation()Позволяет указать TextOrientation для всей страницы. Значение по умолчанию — Horizontal
get_TopMargin()Возвращает или задает расстояние (в пунктах) между верхним краем страницы и верхней границей основного текста.
get_VerticalAlignment()Возвращает или задает вертикальное выравнивание текста на каждой странице в документе или разделе.
GetType() const override
Is(const System::TypeInfo&) const override
set_Bidi(bool)Сеттер для Aspose::Words::PageSetup::get_Bidi.
set_BorderAlwaysInFront(bool)Сеттер для Aspose::Words::PageSetup::get_BorderAlwaysInFront.
set_BorderAppliesTo(Aspose::Words::PageBorderAppliesTo)Сеттер для Aspose::Words::PageSetup::get_BorderAppliesTo.
set_BorderDistanceFrom(Aspose::Words::PageBorderDistanceFrom)Сеттер для Aspose::Words::PageSetup::get_BorderDistanceFrom.
set_BorderSurroundsFooter(bool)Сеттер для Aspose::Words::PageSetup::get_BorderSurroundsFooter.
set_BorderSurroundsHeader(bool)Сеттер для Aspose::Words::PageSetup::get_BorderSurroundsHeader.
set_BottomMargin(double)Сеттер для Aspose::Words::PageSetup::get_BottomMargin.
set_ChapterPageSeparator(Aspose::Words::ChapterPageSeparator)Сеттер для Aspose::Words::PageSetup::get_ChapterPageSeparator.
set_CharactersPerLine(int32_t)Сеттер для Aspose::Words::PageSetup::get_CharactersPerLine.
set_DifferentFirstPageHeaderFooter(bool)Сеттер для Aspose::Words::PageSetup::get_DifferentFirstPageHeaderFooter.
set_FirstPageTray(int32_t)Задает лоток (контейнер) бумаги, используемый для первой страницы раздела. Значение зависит от реализации (принтера).
set_FooterDistance(double)Сеттер для Aspose::Words::PageSetup::get_FooterDistance.
set_Gutter(double)Сеттер для Aspose::Words::PageSetup::get_Gutter.
set_HeaderDistance(double)Сеттер для Aspose::Words::PageSetup::get_HeaderDistance.
set_HeadingLevelForChapter(int32_t)Сеттер для Aspose::Words::PageSetup::get_HeadingLevelForChapter.
set_LayoutMode(Aspose::Words::SectionLayoutMode)Сеттер для Aspose::Words::PageSetup::get_LayoutMode.
set_LeftMargin(double)Сеттер для Aspose::Words::PageSetup::get_LeftMargin.
set_LineNumberCountBy(int32_t)Сеттер для Aspose::Words::PageSetup::get_LineNumberCountBy.
set_LineNumberDistanceFromText(double)Сеттер для Aspose::Words::PageSetup::get_LineNumberDistanceFromText.
set_LineNumberRestartMode(Aspose::Words::LineNumberRestartMode)Сеттер для Aspose::Words::PageSetup::get_LineNumberRestartMode.
set_LinesPerPage(int32_t)Сеттер для Aspose::Words::PageSetup::get_LinesPerPage.
set_LineStartingNumber(int32_t)Сеттер для Aspose::Words::PageSetup::get_LineStartingNumber.
set_Margins(Aspose::Words::Margins)Сеттер для Aspose::Words::PageSetup::get_Margins.
set_MultiplePages(Aspose::Words::Settings::MultiplePagesType)Сеттер для Aspose::Words::PageSetup::get_MultiplePages.
set_OddAndEvenPagesHeaderFooter(bool)Сеттер для Aspose::Words::PageSetup::get_OddAndEvenPagesHeaderFooter.
set_Orientation(Aspose::Words::Orientation)Сеттер для Aspose::Words::PageSetup::get_Orientation.
set_OtherPagesTray(int32_t)Устанавливает лоток (контейнер) бумаги, используемый для всех страниц раздела, кроме первой. Значение зависит от реализации (принтера).
set_PageHeight(double)Сеттер для Aspose::Words::PageSetup::get_PageHeight.
set_PageNumberStyle(Aspose::Words::NumberStyle)Сеттер для Aspose::Words::PageSetup::get_PageNumberStyle.
set_PageStartingNumber(int32_t)Сеттер для Aspose::Words::PageSetup::get_PageStartingNumber.
set_PageWidth(double)Сеттер для Aspose::Words::PageSetup::get_PageWidth.
set_PaperSize(Aspose::Words::PaperSize)Сеттер для Aspose::Words::PageSetup::get_PaperSize.
set_RestartPageNumbering(bool)Сеттер для Aspose::Words::PageSetup::get_RestartPageNumbering.
set_RightMargin(double)Сеттер для Aspose::Words::PageSetup::get_RightMargin.
set_RtlGutter(bool)Сеттер для Aspose::Words::PageSetup::get_RtlGutter.
set_SectionStart(Aspose::Words::SectionStart)Сеттер для Aspose::Words::PageSetup::get_SectionStart.
set_SheetsPerBooklet(int32_t)Сеттер для Aspose::Words::PageSetup::get_SheetsPerBooklet.
set_SuppressEndnotes(bool)True, если сноски печатаются в конце следующего раздела, который не подавляет сноски. Подавленные сноски печатаются перед сносками в этом разделе.
set_TextOrientation(Aspose::Words::TextOrientation)Сеттер для Aspose::Words::PageSetup::get_TextOrientation.
set_TopMargin(double)Сеттер для Aspose::Words::PageSetup::get_TopMargin.
set_VerticalAlignment(Aspose::Words::PageVerticalAlignment)Сеттер для Aspose::Words::PageSetup::get_VerticalAlignment.
static Type()

Примечания

PageSetup object contains all the page setup attributes of a section (left margin, bottom margin, paper size, and so on) as properties.

Примеры

Показывает, как применять и отменять настройки разметки страницы для разделов в документе.

auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);

// Измените свойства разметки страницы для текущего раздела построителя и добавьте текст.
builder->get_PageSetup()->set_Orientation(Aspose::Words::Orientation::Landscape);
builder->get_PageSetup()->set_VerticalAlignment(Aspose::Words::PageVerticalAlignment::Center);
builder->Writeln(u"This is the first section, which landscape oriented with vertically centered text.");

// Если мы начнём новый раздел, используя построитель документа,
// он унаследует текущие свойства разметки страницы построителя.
builder->InsertBreak(Aspose::Words::BreakType::SectionBreakNewPage);

ASSERT_EQ(Aspose::Words::Orientation::Landscape, doc->get_Sections()->idx_get(1)->get_PageSetup()->get_Orientation());
ASSERT_EQ(Aspose::Words::PageVerticalAlignment::Center, doc->get_Sections()->idx_get(1)->get_PageSetup()->get_VerticalAlignment());

// Мы можем вернуть его свойства разметки страницы к значениям по умолчанию, используя метод "ClearFormatting".
builder->get_PageSetup()->ClearFormatting();

ASSERT_EQ(Aspose::Words::Orientation::Portrait, doc->get_Sections()->idx_get(1)->get_PageSetup()->get_Orientation());
ASSERT_EQ(Aspose::Words::PageVerticalAlignment::Top, doc->get_Sections()->idx_get(1)->get_PageSetup()->get_VerticalAlignment());

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

doc->Save(get_ArtifactsDir() + u"PageSetup.ClearFormatting.docx");

См. также