Travailler avec des listes

Une liste dans un document Microsoft Word est un ensemble de propriétés de formatage de paragraphe. Les listes peuvent être utilisées dans les documents pour structurer, organiser et surligner du texte. Les listes sont un excellent moyen d’organiser les données dans des documents de manière à permettre aux lecteurs d’absorber et de comprendre facilement les points clés.

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

Dans Aspose.Words, l’utilisation de listes est représentée par l’espace de noms Lists. Cependant, l’objet List appartient toujours au ListCollection.

Cet article décrit l’utilisation par programmation de listes à l’aide de Aspose.Words.

Créer des 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é ListFormat 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 en Microsoft Word: à puces et numérotées:

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 RemoveNumbers 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 ListIndent
  • Pour diminuer le niveau de liste du paragraphe actuel d’un niveau, appelez ListOutdent

Vous pouvez également utiliser la propriété ListLevelNumber pour obtenir ou définir le niveau de liste du paragraphe.

L’exemple de code suivant 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é 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:

Travailler avec des tableaux dans C# Travailler avec des paragraphes dans C#