Section
Section class
Представляет один раздел в документе.
public sealed class Section : CompositeNode
Конструкторы
Имя | Описание |
---|---|
Section(DocumentBase) | Инициализирует новый экземпляр класса Section. |
Характеристики
Имя | Описание |
---|---|
Body { get; } | Возвращает Тело дочерний узел раздела. |
ChildNodes { get; } | Получает все непосредственные дочерние узлы этого узла. |
Count { get; } | Получает количество непосредственных дочерних элементов этого узла. |
CustomNodeId { get; set; } | Указывает идентификатор пользовательского узла. |
virtual Document { get; } | Получает документ, которому принадлежит этот узел. |
FirstChild { get; } | Получает первого потомка узла. |
HasChildNodes { get; } | Возвращает true, если у этого узла есть дочерние узлы. |
HeadersFooters { get; } | Предоставляет доступ к верхним и нижним колонтитулам раздела. |
override IsComposite { get; } | Возвращает true, так как этот узел может иметь дочерние узлы. |
LastChild { get; } | Получает последний дочерний элемент узла. |
NextSibling { get; } | Получает узел, следующий сразу за этим узлом. |
override NodeType { get; } | Возвращает NodeType.Section . |
PageSetup { get; } | Возвращает объект, представляющий настройки страницы и свойства раздела. |
ParentNode { get; } | Получает непосредственного родителя этого узла. |
PreviousSibling { get; } | Получает узел, непосредственно предшествующий этому узлу. |
ProtectedForForms { get; set; } | Истинно, если раздел защищен для форм. Когда раздел защищен для форм, пользователи могут выбирать и изменять текст только в полях формы в Microsoft Word. |
Range { get; } | Возвращает Диапазон объект, представляющий часть документа, содержащегося в этом узле. |
Методы
Имя | Описание |
---|---|
override Accept(DocumentVisitor) | Принимает посетителя. |
AppendChild(Node) | Добавляет указанный узел в конец списка дочерних узлов для этого узла. |
AppendContent(Section) | Вставляет копию содержимого исходного раздела в конец этого раздела. |
ClearContent() | Очищает раздел. |
ClearHeadersFooters() | Очищает верхние и нижние колонтитулы этого раздела. |
Clone() | Создает дубликат этого раздела. |
Clone(bool) | Создает дубликат узла. |
CreateNavigator() | Зарезервировано для системного использования. IXPathNavigable. |
DeleteHeaderFooterShapes() | Удаляет все фигуры (объекты рисования) из верхних и нижних колонтитулов этого раздела. |
EnsureMinimum() | Гарантирует, что раздел имеет тело с одним абзацем. |
GetAncestor(NodeType) | Получает первого предка указанногоNodeType . |
GetAncestor(Type) | Получает первого предка указанного типа объекта. |
GetChild(NodeType, int, bool) | Возвращает N-й дочерний узел, соответствующий указанному типу. |
GetChildNodes(NodeType, bool) | Возвращает динамическую коллекцию дочерних узлов, соответствующих указанному типу. |
GetEnumerator() | Обеспечивает поддержку для каждой итерации стиля над дочерними узлами этого узла. |
override GetText() | Получает текст этого узла и всех его дочерних элементов. |
IndexOf(Node) | Возвращает индекс указанного дочернего узла в массиве дочерних узлов. |
InsertAfter(Node, Node) | Вставляет указанный узел сразу после указанного ссылочного узла. |
InsertBefore(Node, Node) | Вставляет указанный узел непосредственно перед указанным ссылочным узлом. |
NextPreOrder(Node) | Получает следующий узел в соответствии с алгоритмом обхода дерева предварительного порядка. |
PrependChild(Node) | Добавляет указанный узел в начало списка дочерних узлов для этого узла. |
PrependContent(Section) | Вставляет копию содержимого исходного раздела в начало этого раздела. |
PreviousPreOrder(Node) | Получает предыдущий узел в соответствии с алгоритмом обхода дерева предварительного порядка. |
Remove() | Удаляет себя из родителя. |
RemoveAllChildren() | Удаляет все дочерние узлы текущего узла. |
RemoveChild(Node) | Удаляет указанный дочерний узел. |
RemoveSmartTags() | Удаляет всеSmartTag узлы-потомки текущего узла. |
SelectNodes(string) | Выбирает список узлов, соответствующих выражению XPath. |
SelectSingleNode(string) | Выбирает первый узел, соответствующий выражению XPath. |
ToString(SaveFormat) | Экспортирует содержимое узла в строку в указанном формате. |
ToString(SaveOptions) | Экспортирует содержимое узла в строку, используя указанные параметры сохранения. |
Примечания
Раздел может иметь одинBody
и максимум одинHeaderFooter
каждогоHeaderFooterType
. Тело а также Верхний колонтитул nodes может быть в любом порядке внутри Раздел.
Минимальный действительный раздел должен иметь Тело с одним Параграф.
Каждый раздел имеет собственный набор свойств, определяющих размер страницы, ориентацию, поля и т. д.
Вы можете создать копию раздела, используяClone
. Копия может быть вставлена в тот же или другой документ.
Чтобы добавить, вставить или удалить весь раздел, включая разрыв раздела и свойства раздела , используйте методы класса Разделы объект.
Чтобы скопировать и вставить только содержимое раздела, исключая раздел break и свойства раздела, используйте AppendContent а также PrependContentметоды.
Примеры
Показывает, как создать документ Aspose.Words вручную.
Document doc = new Document();
// Пустой документ содержит один раздел, одно тело и один абзац.
// Вызовите метод "RemoveAllChildren", чтобы удалить все эти узлы,
// и получаем узел документа без дочерних элементов.
doc.RemoveAllChildren();
// Этот документ теперь не имеет составных дочерних узлов, к которым мы можем добавить содержимое.
// Если мы хотим отредактировать его, нам нужно будет повторно заполнить его коллекцию узлов.
// Сначала создайте новый раздел, а затем добавьте его как дочерний к корневому узлу документа.
Section section = new Section(doc);
doc.AppendChild(section);
// Установите некоторые свойства настройки страницы для раздела.
section.PageSetup.SectionStart = SectionStart.NewPage;
section.PageSetup.PaperSize = PaperSize.Letter;
// Разделу нужно тело, которое будет содержать и отображать все его содержимое
// на странице между шапкой и нижним колонтитулом раздела.
Body body = new Body(doc);
section.AppendChild(body);
// Создать абзац, установить некоторые свойства форматирования, а затем добавить его в тело как дочерний элемент.
Paragraph para = new Paragraph(doc);
para.ParagraphFormat.StyleName = "Heading 1";
para.ParagraphFormat.Alignment = ParagraphAlignment.Center;
body.AppendChild(para);
// Наконец, добавьте содержимое для создания документа. Создать прогон,
// установить его внешний вид и содержимое, а затем добавить его как дочерний элемент к абзацу.
Run run = new Run(doc);
run.Text = "Hello World!";
run.Font.Color = Color.Red;
para.AppendChild(run);
Assert.AreEqual("Hello World!", doc.GetText().Trim());
doc.Save(ArtifactsDir + "Section.CreateManually.docx");
Смотрите также
- class CompositeNode
- пространство имен Aspose.Words
- сборка Aspose.Words