Travailler avec des listes
Une liste dans un document Microsoft Word est un ensemble de propriétés de formatage de liste. Les listes peuvent être utilisées dans vos documents pour formater, organiser et mettre en valeur le texte. Les listes sont un excellent moyen d’organiser les données dans des documents et permettent aux lecteurs de comprendre plus facilement les points clés
Chaque liste peut avoir jusqu’à 9 niveaux et les propriétés de formatage, telles que le style des nombres, la valeur de départ, le retrait, la position de la tabulation, etc. sont définies séparément pour chaque niveau.
Dans Aspose.Words, le travail avec des listes est représenté par le module Lists. Toutefois, l’objet List appartient toujours à la collection ListCollection.
Cette rubrique décrit comment travailler par programmation avec des listes à l’aide de Aspose.Words
Création de listes en appliquant le formatage de liste
Aspose.Words permet de créer facilement des listes en appliquant un formatage de liste. DocumentBuilder fournit la propriété DocumentBuilder.list_format qui renvoie un objet ListFormat. Cet objet dispose de plusieurs méthodes pour démarrer et terminer une liste et pour augmenter/diminuer le retrait. Il existe deux types généraux de listes dans Microsoft Word: à puces et numérotées.
- Pour démarrer une liste à puces, appelez ListFormat.apply_bullet_default.
- Pour démarrer une liste numérotée, appelez ListFormat.apply_number_default.
La puce ou le numéro et le formatage sont ajoutés au paragraphe actuel et à tous les autres paragraphes créés à l’aide de DocumentBuilder jusqu’à ce que ListFormat.remove_numbers soit appelé pour arrêter le formatage de la liste à puces.
Dans les documents Word, les listes peuvent comprendre jusqu’à neuf niveaux. Le formatage de la liste pour chaque niveau spécifie quelle puce ou quel numéro est utilisé, le retrait à gauche, l’espace entre la puce et le texte, etc. Les méthodes suivantes modifient le niveau de liste et appliquent les propriétés de formatage du nouveau niveau:
- Pour augmenter le niveau de liste du paragraphe actuel d’un niveau, appelez ListFormat.list_indent
- Pour diminuer le niveau de liste du paragraphe actuel d’un niveau, appelez ListFormat.list_outdent
Les méthodes modifient le niveau de liste et appliquent les propriétés de formatage du nouveau niveau.
L’exemple ci-dessous montre comment créer une liste à plusieurs niveaux.
Spécifier le formatage d’un niveau de liste
Les objets au niveau de la liste sont créés automatiquement lors de la création d’une liste. Utilisez les propriétés et méthodes de la classe ListLevel pour contrôler le formatage des niveaux individuels d’une liste.
Liste de redémarrage pour chaque section
Vous pouvez redémarrer une liste pour chaque section à l’aide de la propriété Propriété is_restart_at_each_section. Notez que cette option n’est prise en charge que dans les formats de document RTF, DOC et DOCX. Cette option sera écrite dans DOCX uniquement si OoxmlCompliance est supérieur à Ecma376.
L’exemple de code suivant montre comment créer une liste et la redémarrer pour chaque section: