new ApiSection()

Класс, представляющий раздел документа.

Методы

Название Описание
GetClassType Возвращает тип класса ApiSection.
GetFooter Возвращает содержимое для указанного типа нижнего колонтитула.
GetHeader Возвращает содержимое для указанного типа заголовка.
GetNext Возвращает следующий раздел, если он существует.
GetPrevious Возвращает предыдущий раздел, если он существует.
RemoveFooter Удаляет нижний колонтитул указанного типа из текущего раздела. После удаления нижний колонтитул будет унаследован от предыдущего раздела, или, если это первый раздел в документе, нижний колонтитул указанного типа не будет представлен.
RemoveHeader Удаляет заголовок указанного типа из текущего раздела. После удаления заголовок будет унаследован от предыдущего раздела, или, если это первый раздел в документе, не будет представлен заголовок указанного типа.
SetEqualColumns Указывает, что все текстовые столбцы в текущем разделе имеют одинаковую ширину.
SetFooterDistance Определяет расстояние от нижнего края страницы до нижнего края нижнего колонтитула.
SetHeaderDistance Определяет расстояние от верхнего края страницы до верхнего края заголовка.
SetNotEqualColumns Указывает, что все столбцы в текущем разделе имеют разную ширину. Количество столбцов равно длине массива aWidth. Длина массива aSpaces ДОЛЖНА БЫТЬ равна (aWidth.length — 1).
SetPageMargins Задает поля для всех страниц в этом разделе.
SetPageSize Указывает свойства (размер и ориентацию) для всех страниц в текущем разделе.
SetTitlePage Указывает, имеет ли текущий раздел в этом документе другой верхний и нижний колонтитулы для первой страницы раздела.
SetType Указывает тип текущего раздела. Тип раздела определяет, как содержимое текущего раздела размещается относительно предыдущего раздела.
WordprocessingML поддерживает пять различных типов разрывов разделов:

  • Разрывы разделов следующей страницы (по умолчанию, если тип не указан), с которых начинается новый раздел на следующей странице.
  • Разрывы разделов нечетных страниц, которые начинают новый раздел на следующей странице с нечетным номером.
  • Разрывы разделов четных страниц, которые начинают новый раздел на следующей четной странице.
  • Непрерывные разрывы разделов, которые начинают новый раздел со следующего абзаца. Это означает, что непрерывные разрывы разделов могут не указывать определенные свойства раздела на уровне страницы, поскольку они должны быть унаследованы от следующего раздела. Однако эти разрывы могут указывать другие свойства раздела, такие как нумерация строк и настройки сносок/концевых сносок.
  • Разрывы разделов столбцов, которые начинают новый раздел в следующем столбце на странице.
ToJSON Преобразует объект ApiSection в объект JSON.

Пример

builder.CreateFile("docx");
var oDocument = Api.GetDocument();
var oParagraph = oDocument.GetElement(0);
var oSection = oDocument.GetFinalSection();
oSection.SetEqualColumns(3, 720);
oParagraph.AddText("This is a text split into 3 equal columns. ");
oParagraph.AddText("The columns are separated by the distance of half an inch.");
oParagraph.AddColumnBreak();
oParagraph.AddText("This text starts from column #2. ");
oParagraph.AddText("This sentence is used to add lines for demonstrative purposes.");
oParagraph.AddColumnBreak();
oParagraph.AddText("This text starts from column #3. ");
oParagraph.AddText("This sentence is used to add lines for demonstrative purposes.");
var oFooter = oSection.GetFooter("default", true);
oSection.SetFooterDistance(1440);
oParagraph = oFooter.GetElement(0);
oParagraph.AddText("This is a page footer. ");
oParagraph.AddText("The distance from the page bottom to the footer is 1 inch (1440 twentieths of a point).");
var oHeader = oSection.GetHeader("default", true);
oSection.SetHeaderDistance(1440);
oParagraph = oHeader.GetElement(0);
oParagraph.AddText("This is a page header. ");
oParagraph.AddText("The distance from the page top to the header is 1 inch (1440 twentieths of a point).");
oSection.SetPageMargins(720, 720, 720, 720);
builder.SaveFile("docx", "ApiSection.docx");
builder.CloseFile();