EM_INSERTTABLE message
Insère une ou plusieurs lignes de tableau identiques avec des cellules vides.
#define EM_INSERTTABLE (WM_USER + 232)
Paramètres
-
wParam
-
Pointeur vers une structure TABLEROWPARMS .
-
lParam
-
Pointeur vers une structure TABLECELLPARMS .
Valeur retournée
Retourne S_OK si la table est insérée ou un code d’erreur si ce n’est pas le cas.
Notes
Si le membre cpStartRow du TABLEROWPARMS est –1, ce message supprime le texte sélectionné (le cas échéant), puis insère des lignes de tableau vides avec les paramètres de ligne et de cellule donnés par wParam et lParam. Il laisse la sélection pointant vers le début de la première cellule de la première ligne. Le client peut ensuite remplir les cellules du tableau en pointant la sélection (ou un ITextRange) vers les différentes marques d’extrémité de cellule et en insérant et en mettant en forme le texte souhaité. Ce texte peut inclure des lignes de tableau imbriquées. Si le membre cpStartRow du TABLEROWPARMS est égal ou supérieur à 0, les lignes de table sont insérées à la position de caractère donnée par cpStartRow. Cela ne modifie la sélection actuelle que si la table est insérée à l’intérieur du texte sélectionné.
Une table Microsoft Rich Edit se compose d’une séquence de lignes de tableau qui, à leur tour, se composent 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, tout comme U+000D (CR). Les paramètres de ligne de table et de cellule sont traités comme une mise en forme de paragraphe spéciale des délimiteurs de ligne de table. La mise en forme contient les informations de la structure TABLEROWPARMS . Les paramètres de cellule donnés par la structure TABLECELLPARMS 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, jusqu’à quinze niveaux de profondeur.
Spécifications
| 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] |
| En-tête |
|