• Post category:ApiSection
  • Запись изменена:24.12.2023

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();
Была ли полезна статья?
Позвольте нам стать лучше