Paragraph

Paragraph class

Représente un paragraphe de texte.

Pour en savoir plus, visitez leTravailler avec des paragraphes article documentaire.

public class Paragraph : CompositeNode

Constructeurs

Nom	La description
Paragraph(DocumentBase)	Initialise une nouvelle instance duParagraph classe.

Propriétés

Nom	La description
BreakIsStyleSeparator { get; }	True si ce saut de paragraphe est un séparateur de style. Un séparateur de style permet à un paragraphe one de se composer de parties ayant des styles de paragraphe différents.
Count { get; }	Obtient le nombre d’enfants immédiats de ce nœud.
CustomNodeId { get; set; }	Spécifie l’identifiant de nœud personnalisé.
virtual Document { get; }	Obtient le document auquel appartient ce nœud.
FirstChild { get; }	Obtient le premier enfant du nœud.
FrameFormat { get; }	Donne accès aux propriétés de formatage du cadre.
HasChildNodes { get; }	Retoursvrai si ce nœud a des nœuds enfants.
override IsComposite { get; }	Retoursvrai car ce nœud peut avoir des nœuds enfants.
IsDeleteRevision { get; }	Renvoie vrai si cet objet a été supprimé dans Microsoft Word alors que le suivi des modifications était activé.
IsEndOfCell { get; }	Vrai si ce paragraphe est le dernier paragraphe d’unCell ; faux sinon.
IsEndOfDocument { get; }	Vrai si ce paragraphe est le dernier paragraphe de la dernière section du document.
IsEndOfHeaderFooter { get; }	Vrai si ce paragraphe est le dernier paragraphe duHeaderFooter (histoire du texte principal) d’unSection ; faux sinon.
IsEndOfSection { get; }	Vrai si ce paragraphe est le dernier paragraphe duBody (histoire du texte principal) d’unSection ; faux sinon.
IsFormatRevision { get; }	Renvoie vrai si le formatage de l’objet a été modifié dans Microsoft Word alors que le suivi des modifications était activé.
IsInCell { get; }	Vrai si ce paragraphe est un enfant immédiat deCell ; faux sinon.
IsInsertRevision { get; }	Renvoie vrai si cet objet a été inséré dans Microsoft Word alors que le suivi des modifications était activé.
IsListItem { get; }	Vrai lorsque le paragraphe est un élément d’une liste à puces ou numérotée dans la révision d’origine.
IsMoveFromRevision { get; }	Retoursvrai si cet objet a été déplacé (supprimé) dans Microsoft Word alors que le suivi des modifications était activé.
IsMoveToRevision { get; }	Retoursvrai si cet objet a été déplacé (inséré) dans Microsoft Word alors que le suivi des modifications était activé.
LastChild { get; }	Obtient le dernier enfant du nœud.
ListFormat { get; }	Donne accès aux propriétés de formatage de liste du paragraphe.
ListLabel { get; }	Obtient unListLabelobjet qui donne accès à la valeur de numérotation de la liste et au formatting pour ce paragraphe.
NextSibling { get; }	Obtient le nœud suivant immédiatement ce nœud.
override NodeType { get; }	RetoursParagraph .
ParagraphBreakFont { get; }	Donne accès au formatage de la police du caractère de saut de paragraphe.
ParagraphFormat { get; }	Donne accès aux propriétés de formatage du paragraphe.
ParentNode { get; }	Obtient le parent immédiat de ce nœud.
ParentSection { get; }	Récupère le parentSection du paragraphe.
ParentStory { get; }	Récupère l’histoire au niveau de la section parent qui peut êtreBody ouHeaderFooter .
PreviousSibling { get; }	Obtient le nœud précédant immédiatement ce nœud.
Range { get; }	Renvoie unRange objet qui représente la partie d’un document contenue dans ce nœud.
Runs { get; }	Donne accès à la collection de morceaux de texte tapés à l’intérieur du paragraphe.

Méthodes

Nom	La description
override Accept(DocumentVisitor)	Accepte un visiteur.
AppendChild(Node)	Ajoute le nœud spécifié à la fin de la liste des nœuds enfants pour ce nœud.
AppendField(string)	Ajoute un champ à ce paragraphe.
AppendField(FieldType, bool)	Ajoute un champ à ce paragraphe.
AppendField(string, string)	Ajoute un champ à ce paragraphe.
Clone(bool)	Crée un duplicata du nœud.
CreateNavigator()	Crée un navigateur qui peut être utilisé pour parcourir et lire des nœuds.
GetAncestor(NodeType)	Obtient le premier ancêtre du spécifiéNodeType .
GetAncestor(Type)	Obtient le premier ancêtre du type d’objet spécifié.
GetChild(NodeType, int, bool)	Renvoie un Nième nœud enfant qui correspond au type spécifié.
GetChildNodes(NodeType, bool)	Renvoie une collection active de nœuds enfants qui correspondent au type spécifié.
GetEffectiveTabStops()	Renvoie un tableau de tous les taquets de tabulation appliqués à ce paragraphe, y compris ceux appliqués indirectement par les styles ou les listes.
GetEnumerator()	Fournit la prise en charge de chaque itération de style sur les nœuds enfants de ce nœud.
override GetText()	Obtient le texte de ce paragraphe, y compris le caractère de fin de paragraphe.
IndexOf(Node)	Renvoie l’index du nœud enfant spécifié dans le tableau de nœuds enfants.
InsertAfter(Node, Node)	Insère le nœud spécifié immédiatement après le nœud de référence spécifié.
InsertBefore(Node, Node)	Insère le nœud spécifié immédiatement avant le nœud de référence spécifié.
InsertField(string, Node, bool)	Insère un champ dans ce paragraphe.
InsertField(FieldType, bool, Node, bool)	Insère un champ dans ce paragraphe.
InsertField(string, string, Node, bool)	Insère un champ dans ce paragraphe.
JoinRunsWithSameFormatting()	Les jointures s’exécutent avec le même formatage dans le paragraphe.
NextPreOrder(Node)	Obtient le nœud suivant selon l’algorithme de traversée de l’arbre de pré-commande.
PrependChild(Node)	Ajoute le nœud spécifié au début de la liste des nœuds enfants pour ce nœud.
PreviousPreOrder(Node)	Obtient le nœud précédent selon l’algorithme de traversée d’arbre de pré-commande.
Remove()	Se supprime du parent.
RemoveAllChildren()	Supprime tous les nœuds enfants du nœud actuel.
RemoveChild(Node)	Supprime le nœud enfant spécifié.
RemoveSmartTags()	Supprime toutSmartTagnœuds descendants du nœud actuel.
SelectNodes(string)	Sélectionne une liste de nœuds correspondant à l’expression XPath.
SelectSingleNode(string)	Sélectionne le premierNode qui correspond à l’expression XPath.
ToString(SaveFormat)	Exporte le contenu du nœud dans une chaîne au format spécifié.
ToString(SaveOptions)	Exporte le contenu du nœud dans une chaîne à l’aide des options de sauvegarde spécifiées.

Remarques

Paragraph est un nœud de niveau bloc et peut être un enfant de classes dérivées de Story ouInlineStory.

Paragraph peut contenir n’importe quel nombre de nœuds et de signets de niveau en ligne.

La liste complète des nœuds enfants pouvant apparaître à l’intérieur d’un paragraphe comprend BookmarkStart ,BookmarkEnd , FieldStart ,FieldSeparator , FieldEnd ,FormField , Comment ,Footnote , Run ,SpecialChar , Shape ,GroupShape , SmartTag.

Un paragraphe valide dans Microsoft Word se termine toujours par un caractère de saut de paragraphe et un paragraphe valide minimal se compose uniquement d’un saut de paragraphe. LeParagraph La classe ajoute automatiquement le caractère de saut de paragraphe approprié à la fin et ce caractère ne fait pas partie des nœuds enfants de la classe .Paragraph , donc aParagraph peut être vide.

N’incluez pas la fin du paragrapheParagraphBreak ou fin de celluleCell caractères à l’intérieur du texte de le paragraphe car cela pourrait rendre le paragraphe invalide lorsque le document est ouvert dans Microsoft Word.

Exemples

Montre comment construire manuellement un document Aspose.Words.

Document doc = new Document();

// Un document vierge contient une section, un corps et un paragraphe.
// Appelez la méthode "RemoveAllChildren" pour supprimer tous ces nœuds,
// et on se retrouve avec un nœud de document sans enfants.
doc.RemoveAllChildren();

// Ce document n'a désormais aucun nœud enfant composite auquel nous pouvons ajouter du contenu.
// Si nous souhaitons le modifier, nous devrons repeupler sa collection de nœuds.
// Commencez par créer une nouvelle section, puis ajoutez-la en tant qu'enfant au nœud du document racine.
Section section = new Section(doc);
doc.AppendChild(section);

// Définissez certaines propriétés de mise en page pour la section.
section.PageSetup.SectionStart = SectionStart.NewPage;
section.PageSetup.PaperSize = PaperSize.Letter;

// Une section a besoin d'un corps, qui contiendra et affichera tout son contenu
// sur la page entre l'en-tête et le pied de page de la section.
Body body = new Body(doc);
section.AppendChild(body);

// Créez un paragraphe, définissez certaines propriétés de mise en forme, puis ajoutez-le en tant qu'enfant au corps.
Paragraph para = new Paragraph(doc);

para.ParagraphFormat.StyleName = "Heading 1";
para.ParagraphFormat.Alignment = ParagraphAlignment.Center;

body.AppendChild(para);

// Enfin, ajoutez du contenu pour faire le document. Créez une course,
// définit son apparence et son contenu, puis l'ajoute en tant qu'enfant au paragraphe.
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");

Voir également

• class CompositeNode
• espace de noms Aspose.Words
• Assemblée Aspose.Words