Appliquer le style de tableau
Un style de tableau définit un ensemble de mises en forme qui peuvent être facilement appliquées à un tableau. Le formatage tel que les bordures, l’ombrage, l’alignement et la police peut être défini dans un style de tableau et appliqué à de nombreux tableaux pour une apparence cohérente.
Aspose.Words prend en charge l’application d’un style de tableau à un tableau ainsi que la lecture des propriétés de n’importe quel style de tableau. Les styles de tableau sont conservés lors du chargement et de l’enregistrement des manières suivantes:
- Les styles de tableau aux formats DOCX et WordML sont conservés lors du chargement et de l’enregistrement dans ces formats
- Les styles de tableau sont conservés lors du chargement et de l’enregistrement au format DOC (mais pas dans un autre format)
- Lors de l’exportation vers d’autres formats, du rendu ou de l’impression, les styles de tableau sont étendus au formatage direct dans le tableau, de sorte que tout le formatage est préservé
Créer un style de tableau
L’utilisateur peut créer un nouveau style et l’ajouter à la collection de styles. La méthode Add est utilisée pour créer un nouveau style de tableau.
L’exemple de code suivant montre comment créer un nouveau style de tableau défini par l’utilisateur:
Copier un style de tableau existant
Si nécessaire, vous pouvez copier un style de tableau qui existe déjà dans un certain document dans votre collection de styles à l’aide de la méthode AddCopy.
Il est important de savoir qu’avec cette copie, les styles liés sont également copiés.
L’exemple de code suivant montre comment importer un style d’un document vers un autre document:
Appliquer un style de tableau existant
Aspose.Words fournit un TableStyle hérité de la classe Style. TableStyle permet à l’utilisateur d’appliquer différentes options de style telles que l’ombrage, le remplissage, l’indentation, CellSpacing et Font, etc.
De plus, Aspose.Words fournit la classe StyleCollection et quelques propriétés de la classe Table pour spécifier le style de tableau avec lequel nous travaillerons: Style, StyleIdentifier, StyleName et StyleOptions.
Aspose.Words fournit également une classe ConditionalStyle qui représente un formatage spécial appliqué à certaines zones d’un tableau avec un style de tableau attribué, ainsi que le ConditionalStyleCollection qui représente une collection d’objets ConditionalStyle. Cette collection contient un ensemble permanent d’éléments représentant un élément pour chaque valeur du type d’énumération ConditionalStyleType. L’énumération ConditionalStyleType définit toutes les zones de tableau possibles pour lesquelles une mise en forme conditionnelle peut être définie dans un style de tableau.
Dans ce cas, la mise en forme conditionnelle peut être définie pour toutes les zones de tableau possibles définies sous le type d’énumération ConditionalStyleType.
L’exemple de code suivant montre comment définir une mise en forme conditionnelle pour la ligne d’en-tête du tableau:
Vous pouvez également choisir les parties du tableau auxquelles appliquer des styles, telles que la première colonne, la dernière colonne, les lignes à bandes. Ils sont répertoriés dans l’énumération TableStyleOptions et sont appliqués via la propriété StyleOptions. L’énumération TableStyleOptions permet une combinaison au niveau du bit de ces fonctionnalités.
L’exemple de code suivant montre comment créer une nouvelle table avec un style de table appliqué:
Les images ci-dessous montrent une représentation du Table Styles en Microsoft Word et de leurs propriétés correspondantes en Aspose.Words.
Travailler avec des styles de tableau
Un style de tableau définit un ensemble de mises en forme qui peuvent être facilement appliquées à un tableau. Le formatage tel que les bordures, l’ombrage, l’alignement et la police peut être défini dans un style de tableau et appliqué à de nombreux tableaux pour une apparence cohérente.
Aspose.Words prend en charge l’application d’un style de tableau à un tableau ainsi que la lecture des propriétés de n’importe quel style de tableau. Les styles de tableau sont conservés lors du chargement et de l’enregistrement des manières suivantes:
- Les styles de tableau aux formats DOCX et WordML sont conservés lors du chargement et de l’enregistrement dans ces formats.
- Les styles de tableau sont conservés lors du chargement et de l’enregistrement au format DOC (mais pas dans un autre format).
- Lors de l’exportation vers d’autres formats, du rendu ou de l’impression, les styles de tableau sont étendus au formatage direct sur le tableau afin que tout le formatage soit préservé.
Actuellement, vous ne pouvez pas créer de nouveaux styles de tableau. Vous pouvez uniquement appliquer à un tableau des styles de tableau intégrés ou des styles de tableau personnalisés qui existent déjà dans le document
Prenez le formatage du style de tableau et appliquez-le en tant que formatage direct
Aspose.Words fournit également la méthode ExpandTableStylesToDirectFormatting pour prendre le formatage trouvé sur un style de tableau et l’étendre aux lignes et aux cellules du tableau en tant que formatage direct. Essayez de combiner la mise en forme avec le style de tableau et le style de cellule.
L’exemple de code suivant montre comment étendre la mise en forme des styles aux lignes et cellules du tableau en tant que mise en forme directe: