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 estilo. Un separador de estilo permite que un párrafo esté formado por partes que tienen diferentes estilos de párrafo. |
| Count { get; } | Obtiene el número de hijos inmediatos de este nodo. |
| CustomNodeId { get; set; } | Especifica el 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; } | Devolucionesverdadero si este nodo tiene nodos secundarios. |
| override IsComposite { get; } | Devolucionesverdadero 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 unSection ; falso en caso contrario. |
| IsEndOfSection { get; } | Verdadero si este párrafo es el último párrafo delBody (historia del texto principal) de unSection ; falso en caso contrario. |
| IsFormatRevision { get; } | Devuelve verdadero si se cambió el formato del objeto en Microsoft Word mientras el seguimiento de cambios estaba habilitado. |
| IsInCell { get; } | Verdadero si este párrafo es 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 en una lista numerada o con viñetas en la revisión original. |
| IsMoveFromRevision { get; } | Devolucionesverdadero si este objeto se movió (eliminó) en Microsoft Word mientras el seguimiento de cambios estaba habilitado. |
| IsMoveToRevision { get; } | Devolucionesverdadero 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 la lista y al formato para este párrafo. |
| NextSibling { get; } | Obtiene el nodo que sigue inmediatamente a este nodo. |
| override NodeType { get; } | DevolucionesParagraph . |
| 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 unRange objeto que representa la parte de un documento contenido en este nodo. |
| Runs { get; } | Proporciona acceso a la colección mecanografiada de fragmentos de texto dentro del párrafo. |
Métodos
| Nombre | Descripción |
|---|---|
| override Accept(DocumentVisitor) | Acepta un visitante. |
| AppendChild(Node) | 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 se puede utilizar para atravesar y leer nodos. |
| GetAncestor(NodeType) | Obtiene el primer ancestro del especificadoNodeType . |
| GetAncestor(Type) | Obtiene el primer antepasado del tipo de objeto especificado. |
| GetChild(NodeType, int, bool) | Devuelve un enésimo nodo secundario 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 mediante 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(Node, Node) | Inserta el nodo especificado inmediatamente después del nodo de referencia especificado. |
| InsertBefore(Node, 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 ejecuciones con el mismo formato en el párrafo. |
| NextPreOrder(Node) | Obtiene el siguiente nodo según el algoritmo transversal del árbol de pedidos anticipados. |
| PrependChild(Node) | Agrega el nodo especificado al principio de la lista de nodos secundarios para este nodo. |
| PreviousPreOrder(Node) | Obtiene el nodo anterior según el algoritmo transversal del árbol de pedidos anticipados. |
| Remove() | Se elimina del padre. |
| RemoveAllChildren() | Elimina todos los nodos secundarios del nodo actual. |
| RemoveChild(Node) | Elimina el nodo secundario especificado. |
| RemoveSmartTags() | Elimina todoSmartTagnodos descendientes del nodo actual. |
| SelectNodes(string) | Selecciona una lista de nodos que coinciden con la expresión XPath. |
| SelectSingleNode(string) | Selecciona el primeroNode que coincide con la expresión XPath. |
| ToString(SaveFormat) | Exporta el contenido del nodo a una cadena en el formato especificado. |
| ToString(SaveOptions) | Exporta el contenido del nodo a una cadena usando las opciones de guardado especificadas. |
Observaciones
Paragraph es un nodo a nivel de bloque y puede ser 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 forma parte de los nodos secundarios delParagraph , por lo tanto aParagraph puede estar vacío.
No incluya el final del párrafo.ParagraphBreak o fin de celdaCell caracteres dentro del texto de el párrafo, ya que podría invalidar el párrafo cuando se abre el documento 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, crea una nueva sección y luego agrégala como secundaria al nodo del documento raíz.
Section section = new Section(doc);
doc.AppendChild(section);
// Establece 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);
// Crea un párrafo, establece algunas propiedades de formato y luego añádelo 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 hacer el documento. Crea una carrera,
// establece su apariencia y contenido, y luego lo agrega como 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
