Section
Contenido
[
Ocultar
]Section class
Representa una sola sección en un documento.
Para obtener más información, visite elTrabajar con secciones Artículo de documentación.
public sealed class Section : CompositeNode
Constructores
| Nombre | Descripción |
|---|---|
| Section(DocumentBase) | Inicializa una nueva instancia de la clase Section. |
Propiedades
| Nombre | Descripción |
|---|---|
| Body { get; } | Devuelve elBody nodo hijo de la sección. |
| Count { get; } | Obtiene el número de hijos inmediatos de este nodo. |
| CustomNodeId { get; set; } | Especifica un identificador de nodo personalizado. |
| virtual Document { get; } | Obtiene el documento al que pertenece este nodo. |
| FirstChild { get; } | Obtiene el primer hijo del nodo. |
| HasChildNodes { get; } | Devuelveverdadero si este nodo tiene nodos secundarios. |
| HeadersFooters { get; } | Proporciona acceso a los nodos de encabezados y pies de página de la sección. |
| override IsComposite { get; } | Devuelveverdadero ya que este nodo puede tener nodos secundarios. |
| LastChild { get; } | Obtiene el último hijo del nodo. |
| NextSibling { get; } | Obtiene el nodo inmediatamente siguiente a este nodo. |
| override NodeType { get; } | DevuelveSection . |
| PageSetup { get; } | Devuelve un objeto que representa la configuración de la página y las propiedades de la sección. |
| ParentNode { get; } | Obtiene el padre inmediato de este nodo. |
| PreviousSibling { get; } | Obtiene el nodo inmediatamente anterior a este nodo. |
| ProtectedForForms { get; set; } | Verdadero si la sección está protegida para formularios. Cuando una sección está protegida para formularios, los usuarios solo pueden seleccionar y modificar texto en los campos de formulario de Microsoft Word. |
| Range { get; } | Devuelve unRangeobjeto que representa la porción de un documento que está contenida en este nodo. |
Métodos
| Nombre | Descripción |
|---|---|
| override Accept(DocumentVisitor) | Acepta un visitante. |
| override AcceptEnd(DocumentVisitor) | |
| override AcceptStart(DocumentVisitor) | |
| AppendChild<T>(T) | Agrega el nodo especificado al final de la lista de nodos secundarios para este nodo. |
| AppendContent(Section) | Inserta una copia del contenido de la sección fuente al final de esta sección. |
| ClearContent() | Borra la sección. |
| ClearHeadersFooters() | Borra los encabezados y pies de página de esta sección. |
| ClearHeadersFooters(bool) | Borra los encabezados y pies de página de esta sección. |
| Clone() | Crea un duplicado de esta sección. |
| Clone(bool) | Crea un duplicado del nodo. |
| CreateNavigator() | Crea un navegador que puede utilizarse para recorrer y leer nodos. |
| DeleteHeaderFooterShapes() | Elimina todas las formas (objetos de dibujo) de los encabezados y pies de página de esta sección. |
| EnsureMinimum() | Asegura que la sección tengaBody con unoParagraph . |
| GetAncestor(NodeType) | Obtiene el primer ancestro del especificadoNodeType . |
| GetAncestor(Type) | Obtiene el primer ancestro del tipo de objeto especificado. |
| GetChild(NodeType, int, bool) | Devuelve un nodo secundario N que coincide con el tipo especificado. |
| GetChildNodes(NodeType, bool) | Devuelve una colección activa de nodos secundarios que coinciden con el tipo especificado. |
| GetEnumerator() | Proporciona soporte para cada iteración de estilo sobre los nodos secundarios de este nodo. |
| override GetText() | Obtiene el texto de este nodo y de todos sus hijos. |
| IndexOf(Node) | Devuelve el índice del nodo secundario especificado en la matriz de nodos secundarios. |
| InsertAfter<T>(T, Node) | Inserta el nodo especificado inmediatamente después del nodo de referencia especificado. |
| InsertBefore<T>(T, Node) | Inserta el nodo especificado inmediatamente antes del nodo de referencia especificado. |
| NextPreOrder(Node) | Obtiene el siguiente nodo según el algoritmo de recorrido del árbol de preorden. |
| PrependChild<T>(T) | Agrega el nodo especificado al comienzo de la lista de nodos secundarios para este nodo. |
| PrependContent(Section) | Inserta una copia del contenido de la sección fuente al comienzo de esta sección. |
| PreviousPreOrder(Node) | Obtiene el nodo anterior según el algoritmo de recorrido del árbol de preorden. |
| Remove() | Se elimina a sí mismo del padre. |
| RemoveAllChildren() | Elimina todos los nodos secundarios del nodo actual. |
| RemoveChild<T>(T) | Elimina el nodo secundario especificado. |
| RemoveSmartTags() | Elimina todoSmartTag nodos descendientes del nodo actual. |
| SelectNodes(string) | Selecciona una lista de nodos que coinciden con la expresión XPath. |
| SelectSingleNode(string) | Selecciona el primerNode que coincide con la expresión XPath. |
| ToString(SaveFormat) | Exporta el contenido del nodo en una cadena en el formato especificado. |
| ToString(SaveOptions) | Exporta el contenido del nodo en una cadena utilizando las opciones de guardado especificadas. |
Observaciones
Section puede tener unoBody y máximo unoHeaderFooter de cada unoHeaderFooterType .Body yHeaderFooter Los nodos pueden estar en cualquier orden dentroSection.
Una sección mínima válida debe tenerBody con unoParagraph.
Cada sección tiene su propio conjunto de propiedades que especifican el tamaño de la página, la orientación, los márgenes, etc.
Puede crear una copia de una sección utilizandoCloneLa copia se puede insertar en el mismo documento o en uno diferente.
Para agregar, insertar o eliminar una sección completa, incluido el salto de sección y las propiedades de sección , utilice los métodos delSections objeto.
Para copiar e insertar solo el contenido de la sección excluyendo la sección break y las propiedades de sección, utiliceAppendContent yPrependContent métodos.
Ejemplos
Muestra cómo construir un documento Aspose.Words a mano.
Document doc = new Document();
// Un documento en blanco contiene una sección, un cuerpo y un párrafo.
// Llama al método "RemoveAllChildren" para eliminar todos esos nodos,
// y terminar con un nodo de documento sin hijos.
doc.RemoveAllChildren();
//Este documento ahora no tiene nodos secundarios compuestos a los que podamos agregar contenido.
// Si deseamos editarlo, necesitaremos volver a llenar su colección de nodos.
// Primero, cree una nueva sección y luego añádala como un elemento secundario al nodo del documento raíz.
Section section = new Section(doc);
doc.AppendChild(section);
// Establezca algunas propiedades de configuración de página para la sección.
section.PageSetup.SectionStart = SectionStart.NewPage;
section.PageSetup.PaperSize = PaperSize.Letter;
// Una sección necesita un cuerpo, que contendrá y mostrará todo su contenido.
// en la página entre el encabezado y el pie de página de la sección.
Body body = new Body(doc);
section.AppendChild(body);
// Cree un párrafo, establezca algunas propiedades de formato y luego añádalo como elemento secundario al cuerpo.
Paragraph para = new Paragraph(doc);
para.ParagraphFormat.StyleName = "Heading 1";
para.ParagraphFormat.Alignment = ParagraphAlignment.Center;
body.AppendChild(para);
// Finalmente, agrega algo de contenido para completar el documento. Crea una ejecución.
// establece su apariencia y contenido, y luego lo agrega como un elemento secundario al párrafo.
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");
Ver también
- class CompositeNode
- espacio de nombres Aspose.Words
- asamblea Aspose.Words
