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.

ITextRow ::Apply Applique les attributs de mise en forme de cet objet de ligne de texte aux lignes spécifiées dans le ITextRange2 associé.
ITextRow ::CanChange Détermine si des modifications peuvent être apportées à cette ligne.
ITextRow ::GetAlignment Obtient l’alignement horizontal d’une ligne.
ITextRow ::GetCellAlignment Obtient l’alignement vertical de la cellule active.
ITextRow ::GetCellBorderColors Obtient les couleurs de bordure de la cellule active.
ITextRow ::GetCellBorderWidths Obtient les largeurs de bordure de la cellule active.
ITextRow ::GetCellColorBack Obtient la couleur d’arrière-plan de la cellule active.
ITextRow ::GetCellColorFore Obtient la couleur de premier plan de la cellule active.
ITextRow ::GetCellCount Obtient le nombre de cellules dans cette ligne.
ITextRow ::GetCellCountCache Obtient le nombre de cellules mises en cache pour cette ligne.
ITextRow ::GetCellIndex Obtient l’index de la cellule active pour laquelle obtenir ou définir des paramètres.
ITextRow ::GetCellMargin Obtient la marge de cellule de cette ligne.
ITextRow ::GetCellMergeFlags Obtient les indicateurs de fusion de la cellule active.
ITextRow ::GetCellShading Obtient l’ombrage de la cellule active.
ITextRow ::GetCellVerticalText Obtient le paramètre de texte vertical de la cellule active.
ITextRow ::GetCellWidth Obtient la largeur de la cellule active.
ITextRow ::GetHeight Obtient la hauteur de la ligne.
ITextRow ::GetIndent Obtient le retrait de cette ligne.
ITextRow ::GetKeepTogether Obtient si cette ligne est autorisée à être rompue entre les pages.
ITextRow ::GetKeepWithNext Obtient si cette ligne doit apparaître sur la même page que la ligne qui la suit.
ITextRow ::GetNestLevel Obtient le niveau de nid d’une table.
ITextRow ::GetProperty Obtient la valeur de la propriété spécifiée. (ITextRow.GetProperty)
ITextRow ::GetRTL Obtient si cette ligne a une orientation de droite à gauche.
ITextRow ::Insert Insère une ligne, ou des lignes, à l’emplacement identifié par l’objet ITextRange2 associé.
ITextRow ::IsEqual Compare deux lignes de table pour déterminer si elles ont les mêmes propriétés.
ITextRow ::Reset Réinitialise une ligne.
ITextRow ::SetAlignment Définit l’alignement horizontal d’une ligne.
ITextRow ::SetCellAlignment Définit l’alignement vertical de la cellule active.
ITextRow ::SetCellBorderColors Définit les couleurs de bordure de la cellule active.
ITextRow ::SetCellBorderWidths Définit les largeurs de bordure de la cellule active.
ITextRow ::SetCellColorBack Définit la couleur d’arrière-plan de la cellule active.
ITextRow ::SetCellColorFore Définit la couleur de premier plan de la cellule active.
ITextRow ::SetCellCount Définit le nombre de cellules dans une ligne.
ITextRow ::SetCellCountCache Définit le nombre de cellules mises en cache pour une ligne.
ITextRow ::SetCellIndex Définit l’index de la cellule active.
ITextRow ::SetCellMargin Définit la marge de cellule d’une ligne.
ITextRow ::SetCellMergeFlags Définit les indicateurs de fusion de la cellule active.
ITextRow ::SetCellShading Définit l’ombrage de la cellule active.
ITextRow ::SetCellVerticalText Définit le paramètre de texte vertical de la cellule active.
ITextRow ::SetCellWidth Définit la largeur de cellule active en twips.
ITextRow ::SetHeight Définit la hauteur d’une ligne.
ITextRow ::SetIndent Définit le retrait d’une ligne.
ITextRow ::SetKeepTogether Définit si cette ligne est autorisée à être rompue entre les pages.
ITextRow ::SetKeepWithNext Définit si une ligne doit apparaître sur la même page que la ligne qui la suit.
ITextRow ::SetProperty Définit la valeur de la propriété spécifiée. (ITextRow.SetProperty)
ITextRow ::SetRTL Définit si cette ligne a une orientation de droite à gauche.

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

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	tom.h