Structure GETTEXTEX (richedit.h)

Article
03/01/2024

Contient les informations utilisées pour obtenir du texte à partir d’un contrôle d’édition enrichi. Structure utilisée avec le message EM_GETTEXTEX .

Syntaxe

typedef struct _gettextex {
  DWORD  cb;
  DWORD  flags;
  UINT   codepage;
  LPCSTR lpDefaultChar;
  LPBOOL lpUsedDefChar;
} GETTEXTEX;

Membres

cb

Type : DWORD

Taille, en octets, de la mémoire tampon utilisée pour stocker le texte récupéré.

flags

Type : DWORD

Valeur spécifiant une opération de texte. Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
GT_DEFAULT	Tout le texte est récupéré selon les critères suivants : Les retours chariots (U+000D) ne sont pas traduits en CRLF (U+000D U+000A). Les caractères de structure de table et d’objet mathématique sont supprimés (voir GT_RAWTEXT). Le texte masqué est inclus. Les numéros de liste ne sont pas inclus.
GT_NOHIDDENTEXT	Le texte masqué n’est pas inclus dans le texte récupéré.
GT_RAWTEXT	Le texte est récupéré exactement tel qu’il apparaît dans la mémoire. Cela inclut des caractères de structure spéciaux pour les délimiteurs de lignes et de cellules de table (voir Remarques pour EM_INSERTTABLE) ainsi que les délimiteurs d’objets mathématiques (délimiteur de début U+FDD0, délimiteur d’argumentS U+FDEE et délimiteur de fin U+FDDF) et les marqueurs d’objets (U+FFFC). Cela maintient l’alignement de la position des caractères entre le texte récupéré et le texte en mémoire.
GT_SELECTION	Récupérez le texte de la sélection actuelle.
GT_USECRLF	Lors de la copie de texte, traduisez chaque CR en CR/LF.

codepage

Type : UINT

Page de code utilisée dans la traduction. Il est CP_ACP pour la page de code ANSI et 1200 pour Unicode.

lpDefaultChar

Type : LPCSTR

Caractère utilisé si un caractère large ne peut pas être représenté dans la page de code spécifiée. Elle est utilisée uniquement si la page de code n’est pas 1200 (Unicode). Si ce membre a la valeur NULL, une valeur système par défaut est utilisée.

lpUsedDefChar

Type : LPBOOL

Indicateur qui indique si le caractère par défaut (lpDefaultChar) a été utilisé. Ce membre est utilisé uniquement si la page de code n’est pas 1200 ou CP_UTF8 (Unicode). L’indicateur est TRUE si un ou plusieurs caractères larges de la chaîne source ne peuvent pas être représentés dans la page de code spécifiée. Sinon, l’indicateur est FALSE. Ce membre peut avoir la valeur NULL.

Remarques

Le message EM_GETTEXTEX est plus rapide lorsque lpDefaultChar et lpUsedDefChar ont lavaleur NULL.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	richedit.h

Voir aussi

EM_GETTEXTEX

Partager via