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 les documents et permettent aux lecteurs de mieux comprendre les points clés.

Chaque liste peut avoir jusqu’à 9 niveaux et les propriétés de formatage, telles que le style numérique, la valeur de départ, le retrait, la position de tabulation et d’autres sont définies séparément pour chaque niveau.

Cet article décrit le travail de programmation avec des listes utilisant Aspose.Words.

Création de Listes en Appliquant une Mise en Forme de Liste

Aspose.Words permet de créer facilement des listes en appliquant un formatage de liste. DocumentBuilder fournit la propriété ListFormat qui renvoie un objet ListFormat. Cet objet a plusieurs méthodes pour commencer 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:

La puce ou le numéro et la mise en forme sont ajoutés au paragraphe actuel et à tous les autres paragraphes créés à l’aide de DocumentBuilder jusqu’à ce que RemoveNumbers soit appelé pour arrêter la mise en forme de la liste à puces.

Dans les documents Word, les listes peuvent comporter jusqu’à neuf niveaux. La mise en forme 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 la liste et appliquent les propriétés de mise en forme du nouveau niveau:

Les méthodes modifient le niveau de la liste et appliquent les propriétés de mise en forme du nouveau niveau.

L’exemple de code suivant montre comment créer une liste à plusieurs niveaux:

Spécifier le formatage pour un niveau de liste

Les objets au niveau de la liste sont créés automatiquement lorsqu’une liste est créée. Utilisez les propriétés et les méthodes de la classe ListLevel pour contrôler la mise en forme 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é IsRestartAtEachSection. 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:

Utilisation de tables dans Java Travailler avec des paragraphes dans Java