Paragraph
Contenu
[
Cacher
]Paragraph class
Représente un paragraphe de texte.
Pour en savoir plus, visitez leTravailler avec des paragraphes article de documentation.
public class Paragraph : CompositeNode
Constructeurs
| Nom | La description |
|---|---|
| Paragraph(DocumentBase) | Initialise une nouvelle instance duParagraph classe. |
Propriétés
| Nom | La description |
|---|---|
| BreakIsStyleSeparator { get; } | Vrai si ce saut de paragraphe est un séparateur de style. Un séparateur de style permet à un paragraphe 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 true si la mise en forme de l’objet a été modifiée 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 la liste du paragraphe. |
| ListLabel { get; } | Obtient unListLabelobjet qui donne accès à la valeur de numérotation de liste et au formatage pour ce paragraphe. |
| NextSibling { get; } | Obtient le nœud suivant immédiatement ce nœud. |
| override NodeType { get; } | RetoursParagraph . |
| ParagraphBreakFont { get; } | Donne accès à la mise en forme de la police du caractère de saut de paragraphe. |
| ParagraphFormat { get; } | Donne accès aux propriétés de formatage des paragraphes. |
| 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 unRangeobjet qui représente la partie d’un document contenue dans ce nœud. |
| Runs { get; } | Donne accès à la collection tapée de morceaux de texte à l’intérieur du paragraphe. |
Méthodes
| Nom | La description |
|---|---|
| override Accept(DocumentVisitor) | Accepte un visiteur. |
| override AcceptEnd(DocumentVisitor) | Accepte un visiteur pour visiter la fin du paragraphe du document. |
| override AcceptStart(DocumentVisitor) | Accepte un visiteur pour visiter le début du paragraphe du document. |
| AppendChild<T>(T) | 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 doublon du nœud. |
| CreateNavigator() | Crée un navigateur qui peut être utilisé pour parcourir et lire les 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 des styles ou des listes. |
| GetEnumerator() | Fournit un support pour 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<T>(T, Node) | Insère le nœud spécifié immédiatement après le nœud de référence spécifié. |
| InsertBefore<T>(T, 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 parcours de l’arbre de pré-ordre. |
| PrependChild<T>(T) | 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 parcours de l’arbre de pré-ordre. |
| Remove() | Se supprime du parent. |
| RemoveAllChildren() | Supprime tous les nœuds enfants du nœud actuel. |
| RemoveChild<T>(T) | Supprime le nœud enfant spécifié. |
| RemoveSmartTags() | Supprime toutSmartTag nœ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 en utilisant les 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 qui peuvent apparaître dans un paragraphe se compose de 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 simplement d’un saut de paragraphe.Paragraph 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 laParagraph , donc aParagraph peut être vide.
Ne pas inclure 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 un document Aspose.Words à la main.
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 se retrouver 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.
// Tout d’abord, créez une nouvelle section, puis ajoutez-la en tant qu’enfant au nœud racine du document.
Section section = new Section(doc);
doc.AppendChild(section);
// Définissez certaines propriétés de configuration de 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 formatage, 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 compléter le document. Créez une exécution,
// définissez son apparence et son contenu, puis ajoutez-le 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
