Travailler avec les listes
Une liste dans une Microsoft Word document est un ensemble de propriétés de formatage de liste. Des listes peuvent être utilisées dans vos documents pour formater, organiser et souligner le texte. Les listes sont un excellent moyen d’organiser les données dans les documents, et elles facilitent la compréhension des points clés par les lecteurs.
Chaque liste peut avoir jusqu’à 9 niveaux et les propriétés de formatage, tels que le style de nombre, la valeur de départ, le tiret, la position de l’onglet, et d’autres sont définis séparément pour chaque niveau.
Cet article décrit le travail programmatique avec les listes en utilisant Aspose.Words.
Création de listes en appliquant le formatage de la liste
Aspose.Words permet la création facile de listes en appliquant le formatage de la liste. DocumentBuilder fournit les ListFormat un bien qui rend une ListFormat objet. Cet objet a plusieurs méthodes pour démarrer et terminer une liste et augmenter/diminuer le tiret. Il existe deux types généraux de listes Microsoft Word: balisé et numéroté:
- Pour lancer une liste, appelez ListFormat.ApplyBulletDefault
- Pour démarrer une liste numérotée, appelez ListFormat.ApplyNumberDefault
La puce ou le nombre et le formatage sont ajoutés au paragraphe actuel et à tous les autres paragraphes créés en utilisant DocumentBuilder jusqu’à RemoveNumbers est appelé pour arrêter le formatage des listes par puces.
Dans les documents Word, les listes peuvent comprendre jusqu’à neuf niveaux. Le formatage de la liste pour chaque niveau indique le point ou le nombre utilisé, le tiret gauche, l’espace entre le point et le texte, etc. Les méthodes suivantes changent le niveau de la liste et appliquent les propriétés de formatage du nouveau niveau:
- Oui. Pour augmenter le niveau de liste du paragraphe actuel d’un niveau, appeler ListFormat.ListIndent
- Oui. Pour réduire le niveau de liste du paragraphe actuel d’un niveau, appelez ListFormat.ListOutdent
Les méthodes changent le niveau de la liste et appliquent les propriétés de formatage du nouveau niveau.
L’exemple de code suivant montre comment construire une liste à plusieurs niveaux:
Spécifier le formatage pour un niveau de liste
Les objets list-level sont créés automatiquement lorsqu’une liste est créée. Utiliser les propriétés et les méthodes de ListLevel classe pour contrôler le formatage des niveaux individuels d’une liste.
Redémarrer la liste pour chaque section
Vous pouvez redémarrer une liste pour chaque section en utilisant IsRestartAtEachSection propriété. Notez que cette option n’est prise en charge que dans les formats RTF, DOC et DOCX. Cette option ne sera écrite à DOCX que si OoxmlCompliance est plus élevé alors Ecma376.
L’exemple de code suivant montre comment créer une liste et la redémarrer pour chaque section: