Paragraph
Contenido
[
Ocultar
]Paragraph class
Representa un párrafo de texto.
Para obtener más información, visite elTrabajar con párrafos Artículo de documentación.
public class Paragraph : CompositeNode
Constructores
| Nombre | Descripción |
|---|---|
| Paragraph(DocumentBase) | Inicializa una nueva instancia delParagraph clase. |
Propiedades
| Nombre | Descripción |
|---|---|
| BreakIsStyleSeparator { get; } | Verdadero si este salto de párrafo es un separador de estilos. Un separador de estilos permite que un párrafo conste de partes con diferentes estilos de párrafo. |
| 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. |
| FrameFormat { get; } | Proporciona acceso a las propiedades de formato del marco. |
| HasChildNodes { get; } | Devuelveverdadero si este nodo tiene nodos secundarios. |
| override IsComposite { get; } | Devuelveverdadero ya que este nodo puede tener nodos secundarios. |
| IsDeleteRevision { get; } | Devuelve verdadero si este objeto se eliminó en Microsoft Word mientras el seguimiento de cambios estaba habilitado. |
| IsEndOfCell { get; } | Verdadero si este párrafo es el último párrafo de unCell ; falso en caso contrario. |
| IsEndOfDocument { get; } | Verdadero si este párrafo es el último párrafo de la última sección del documento. |
| IsEndOfHeaderFooter { get; } | Verdadero si este párrafo es el último párrafo delHeaderFooter (historia del texto principal) de unaSection ; falso en caso contrario. |
| IsEndOfSection { get; } | Verdadero si este párrafo es el último párrafo delBody (historia del texto principal) de unaSection ; falso en caso contrario. |
| IsFormatRevision { get; } | Devuelve verdadero si se cambió el formato del objeto en Microsoft Word mientras estaba habilitado el seguimiento de cambios. |
| IsInCell { get; } | Verdadero si este párrafo es un hijo inmediato deCell ; falso en caso contrario. |
| IsInsertRevision { get; } | Devuelve verdadero si este objeto se insertó en Microsoft Word mientras el seguimiento de cambios estaba habilitado. |
| IsListItem { get; } | Verdadero cuando el párrafo es un elemento de una lista numerada o con viñetas en la revisión original. |
| IsMoveFromRevision { get; } | Devuelveverdadero Si este objeto se movió (eliminó) en Microsoft Word mientras el seguimiento de cambios estaba habilitado. |
| IsMoveToRevision { get; } | Devuelveverdadero Si este objeto se movió (insertó) en Microsoft Word mientras el seguimiento de cambios estaba habilitado. |
| LastChild { get; } | Obtiene el último hijo del nodo. |
| ListFormat { get; } | Proporciona acceso a las propiedades de formato de lista del párrafo. |
| ListLabel { get; } | Obtiene unListLabelobjeto que proporciona acceso al valor de numeración de lista y formato para este párrafo. |
| NextSibling { get; } | Obtiene el nodo inmediatamente siguiente a este nodo. |
| override NodeType { get; } | DevuelveParagraph . |
| ParagraphBreakFont { get; } | Proporciona acceso al formato de fuente del carácter de salto de párrafo. |
| ParagraphFormat { get; } | Proporciona acceso a las propiedades de formato de párrafo. |
| ParentNode { get; } | Obtiene el padre inmediato de este nodo. |
| ParentSection { get; } | Recupera el padreSection del párrafo. |
| ParentStory { get; } | Recupera la historia a nivel de sección principal que se puedeBody oHeaderFooter . |
| PreviousSibling { get; } | Obtiene el nodo inmediatamente anterior a este nodo. |
| Range { get; } | Devuelve unRangeobjeto que representa la porción de un documento que está contenida en este nodo. |
| Runs { get; } | Proporciona acceso a la colección escrita de fragmentos de texto dentro del párrafo. |
Métodos
| Nombre | Descripción |
|---|---|
| override Accept(DocumentVisitor) | Acepta un visitante. |
| override AcceptEnd(DocumentVisitor) | Acepta a un visitante por visitar el final del párrafo del documento. |
| override AcceptStart(DocumentVisitor) | Acepta a un visitante por visitar el inicio del párrafo del documento. |
| AppendChild<T>(T) | Agrega el nodo especificado al final de la lista de nodos secundarios para este nodo. |
| AppendField(string) | Agrega un campo a este párrafo. |
| AppendField(FieldType, bool) | Agrega un campo a este párrafo. |
| AppendField(string, string) | Agrega un campo a este párrafo. |
| Clone(bool) | Crea un duplicado del nodo. |
| CreateNavigator() | Crea un navegador que puede utilizarse para recorrer y leer nodos. |
| 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. |
| GetEffectiveTabStops() | Devuelve una matriz de todas las tabulaciones aplicadas a este párrafo, incluidas las aplicadas indirectamente por estilos o listas. |
| GetEnumerator() | Proporciona soporte para cada iteración de estilo sobre los nodos secundarios de este nodo. |
| override GetText() | Obtiene el texto de este párrafo incluido el carácter de final de párrafo. |
| 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. |
| InsertField(string, Node, bool) | Inserta un campo en este párrafo. |
| InsertField(FieldType, bool, Node, bool) | Inserta un campo en este párrafo. |
| InsertField(string, string, Node, bool) | Inserta un campo en este párrafo. |
| JoinRunsWithSameFormatting() | Une líneas con el mismo formato en el párrafo. |
| 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. |
| 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
Paragraph es un nodo a nivel de bloque y puede ser un hijo de clases derivadas de Story oInlineStory.
Paragraph Puede contener cualquier número de nodos y marcadores de nivel en línea.
La lista completa de nodos secundarios que pueden aparecer dentro de un párrafo consta de BookmarkStart ,BookmarkEnd , FieldStart ,FieldSeparator , FieldEnd ,FormField , Comment ,Footnote , Run ,SpecialChar , Shape ,GroupShape , SmartTag.
Un párrafo válido en Microsoft Word siempre termina con un carácter de salto de párrafo y un párrafo válido mínimo consta solo de un salto de párrafo. ElParagraph La clase agrega automáticamente el carácter de salto de párrafo apropiado al final y este carácter no es parte de los nodos secundarios de la clase.Paragraph , por lo tanto aParagraph Puede estar vacío.
No incluya el final del párrafoParagraphBreak o fin de celdaCell caracteres dentro del texto del párrafo, ya que podría hacer que el párrafo sea inválido cuando el documento se abra en Microsoft Word.
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
