Share via

Estrutura GETTEXTEX (richedit.h)

  • Artigo

Contém informações usadas para obter texto de um controle de edição avançada. Essa estrutura usada com a mensagem EM_GETTEXTEX .

Sintaxe

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

Membros

cb

Tipo: DWORD

O tamanho, em bytes, do buffer usado para armazenar o texto recuperado.

flags

Tipo: DWORD

Valor que especifica uma operação de texto. Esse membro pode ser um dos valores a seguir.

Valor Significado
GT_DEFAULT
 Todo o texto é recuperado de acordo com os seguintes critérios:
  • Os retornos de carro (U+000D) não são convertidos em CRLF (U+000D U+000A).
  • Os caracteres de estrutura de objeto de tabela e matemática são removidos (consulte GT_RAWTEXT).
  • O texto oculto está incluído.
  • Os números da lista não estão incluídos.
GT_NOHIDDENTEXT
 O texto oculto não está incluído no texto recuperado.
GT_RAWTEXT
 O texto é recuperado exatamente como aparece na memória. Isso inclui caracteres de estrutura especiais para delimitadores de linha de tabela e célula (consulte Comentários para EM_INSERTTABLE), bem como delimitadores de objeto matemático (U+FDD0 delimitador inicial, delimitador de argumento U+FDEE e delimitador final U+FDDF) e marcadores de objeto (U+FFFC). Isso mantém o alinhamento de posição de caractere entre o texto recuperado e o texto na memória.
GT_SELECTION
 Recupere o texto da seleção atual.
GT_USECRLF
 Ao copiar texto, converta cada CR em um CR/LF.

codepage

Tipo: UINT

Página de código usada na tradução. É CP_ACP para a página de código ANSI e 1200 para Unicode.

lpDefaultChar

Tipo: LPCSTR

O caractere usado se um caractere largo não puder ser representado na página de código especificada. Ele será usado somente se a página de código não for 1200 (Unicode). Se esse membro for NULL, um valor padrão do sistema será usado.

lpUsedDefChar

Tipo: LPBOOL

Um sinalizador que indica se o caractere padrão (lpDefaultChar) foi usado. Esse membro será usado somente se a página de código não for 1200 ou CP_UTF8 (Unicode). O sinalizador será TRUE se um ou mais caracteres largos na cadeia de caracteres de origem não puderem ser representados na página de código especificada. Caso contrário, o sinalizador será FALSE. Esse membro pode ser NULL.

Comentários

A mensagem EM_GETTEXTEX é mais rápida quando lpDefaultChar e lpUsedDefChar são NULL.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho richedit.h

Confira também

EM_GETTEXTEX