Interface ITextRow (tom.h)

L’interface ITextRow fournit des méthodes permettant d’insérer une ou plusieurs lignes de table identiques et de récupérer et de modifier les propriétés de ligne de table. Pour insérer des lignes non identiques, appelez ITextRow ::Insert pour chaque configuration de ligne différente.

Héritage

L’interface ITextRow hérite de l’interface IDispatch. ITextRow a également les types de membres suivants :

Méthodes

L’interface ITextRow possède ces méthodes.

Remarques

Pour sélectionner une table, une ligne ou une cellule, utilisez ITextRange ::Expand, avec le paramètre Unit défini sur tomTable, tomRow ou tomCell, respectivement. Ces unités peuvent également être utilisées avec les méthodes ITextRange ::Move pour naviguer et sélectionner plusieurs lignes ou cellules.

Certaines des propriétés ITextRow s’appliquent à la ligne entière, comme l’alignement de ligne. En outre, il existe un certain nombre de propriétés, telles que l’alignement des cellules, qui s’appliquent à une cellule avec l’index défini via la méthode ITextRow ::SetCellIndex . Cette cellule est appelée cellule active.

ITextRow fonctionne de la même façon que ITextPara2, mais ne modifie pas le document tant que les méthodes ITextRow ::Apply ou ITextRow ::Insert n’ont pas été appelées. En outre, les paramètres de ligne et de cellule sont toujours actifs, c’est-à-dire qu’ils ne peuvent pas avoir la valeur tomDefault.

Lors de l’initialisation, l’objet ITextRow acquiert les propriétés de ligne de table, le cas échéant, à la fin active de l’ITextRange2 associé. La méthode ITextRow ::Reset peut être utilisée pour mettre à jour ces propriétés vers les valeurs actuelles de l’objet ITextRange2 .

Une table de contrôle d’édition enrichie se compose d’une séquence de lignes de tableau, qui se composent à leur tour de séquences de paragraphes. Une ligne de tableau commence par le paragraphe délimiteur à deux caractères spécial U+FFF9 U+000D et se termine par le paragraphe délimiteur à deux caractères U+FFFB U+000D. Chaque cellule est terminée par la marque de cellule U+0007, qui est traitée comme une marque de fin de paragraphe comme U+000D (CR). Les paramètres de ligne et de cellule du tableau sont traités comme une mise en forme de paragraphe spéciale des délimiteurs de lignes de tableau. Les paramètres de cellule sont stockés dans une version développée du tableau d’onglets. Ce format permet aux tables d’être imbriquées dans d’autres tables et d’atteindre quinze niveaux de profondeur.

L’architecture est assez flexible en ce sens que chaque ligne de table peut avoir des paramètres de ligne de table valides, quels que soient les paramètres des autres lignes (à l’exception des indicateurs de fusion verticaux). Par exemple, le nombre de cellules et les retraits de début des lignes de tableau peuvent différer, contrairement au format HTML qui a un format rectangulaire n×m avec toutes les lignes commençant par le même retrait.

En revanche, aucune description de table formelle n’est stockée nulle part. Des informations telles que le nombre de lignes doivent être résolues en parcourant la table. Par exemple, le nombre de lignes d’une table peut être obtenu en appelant ITextRange ::StartOf (tomTable, tomFalse, NULL) pour se déplacer au début de la table active, puis en appelant ITextRange ::Move (tomRow, tomForward, &dcRow). La quantité &dcRow + 1 contient ensuite le nombre de lignes dans la table, car le déplacement par incréments tomRow ne dépasse pas la dernière ligne de table.

Configuration requise