Section
Contenu
[
Cacher
]Section class
Représente une seule section dans un document.
Pour en savoir plus, visitez leTravailler avec des sections article de documentation.
public sealed class Section : CompositeNode
Constructeurs
| Nom | La description |
|---|---|
| Section(DocumentBase) | Initialise une nouvelle instance de la classe Section. |
Propriétés
| Nom | La description |
|---|---|
| Body { get; } | Renvoie leBody nœud enfant de la section. |
| 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. |
| HasChildNodes { get; } | Retoursvrai si ce nœud a des nœuds enfants. |
| HeadersFooters { get; } | Fournit l’accès aux nœuds d’en-têtes et de pieds de page de la section. |
| override IsComposite { get; } | Retoursvrai car ce nœud peut avoir des nœuds enfants. |
| LastChild { get; } | Obtient le dernier enfant du nœud. |
| NextSibling { get; } | Obtient le nœud suivant immédiatement ce nœud. |
| override NodeType { get; } | RetoursSection . |
| PageSetup { get; } | Renvoie un objet qui représente la configuration de la page et les propriétés de la section. |
| ParentNode { get; } | Obtient le parent immédiat de ce nœud. |
| PreviousSibling { get; } | Obtient le nœud précédant immédiatement ce nœud. |
| ProtectedForForms { get; set; } | Vrai si la section est protégée contre les formulaires. Lorsqu’une section est protégée contre les formulaires, les utilisateurs peuvent sélectionner et modifier du texte uniquement dans les champs de formulaire Microsoft Word. |
| Range { get; } | Renvoie unRangeobjet qui représente la partie d’un document contenue dans ce nœud. |
Méthodes
| Nom | La description |
|---|---|
| override Accept(DocumentVisitor) | Accepte un visiteur. |
| override AcceptEnd(DocumentVisitor) | |
| override AcceptStart(DocumentVisitor) | |
| AppendChild<T>(T) | Ajoute le nœud spécifié à la fin de la liste des nœuds enfants pour ce nœud. |
| AppendContent(Section) | Insère une copie du contenu de la section source à la fin de cette section. |
| ClearContent() | Efface la section. |
| ClearHeadersFooters() | Efface les en-têtes et les pieds de page de cette section. |
| ClearHeadersFooters(bool) | Efface les en-têtes et les pieds de page de cette section. |
| Clone() | Crée un doublon de cette section. |
| 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. |
| DeleteHeaderFooterShapes() | Supprime toutes les formes (objets de dessin) des en-têtes et des pieds de page de cette section. |
| EnsureMinimum() | Garantit que la section aBody avec unParagraph . |
| 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é. |
| 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 nœud et de tous ses enfants. |
| 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é. |
| 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. |
| PrependContent(Section) | Insère une copie du contenu de la section source au début de cette section. |
| 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
Section peut en avoir unBody et un maximum d’unHeaderFooter de chaqueHeaderFooterType .Body etHeaderFooter nodes peut être dans n’importe quel ordre à l’intérieurSection.
Une section minimale valide doit avoirBody avec unParagraph.
Chaque section possède son propre ensemble de propriétés qui spécifient la taille de la page, l’orientation, les marges, etc.
Vous pouvez créer une copie d’une section en utilisantClone. La copie peut être insérée dans le même document ou un document différent.
Pour ajouter, insérer ou supprimer une section entière, y compris le saut de section et les propriétés de section , utilisez les méthodes deSections objet.
Pour copier et insérer uniquement le contenu de la section à l’exclusion de la section break et des propriétés de section, utilisezAppendContent etPrependContent méthodes.
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
