GETTEXTEX-Struktur (richedit.h)

  • Artikel

Enthält Informationen, die zum Abrufen von Text aus einem umfangreichen Bearbeitungssteuerelement verwendet werden. Diese Struktur wird mit der EM_GETTEXTEX-Nachricht verwendet.

Syntax

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

Member

cb

Typ: DWORD

Die Größe des Puffers in Bytes, der zum Speichern des abgerufenen Texts verwendet wird.

flags

Typ: DWORD

Wert, der einen Textvorgang angibt. Dieser Member kann einer der folgenden Werte sein.

Wert Bedeutung
GT_DEFAULT
 Der gesamte Text wird nach den folgenden Kriterien abgerufen:
  • Wagenrückläufe (U+000D) werden nicht in CRLF (U+000D U+000A) übersetzt.
  • Tabellen- und Mathematische Objektstrukturzeichen werden entfernt (siehe GT_RAWTEXT).
  • Ausgeblendeter Text ist enthalten.
  • Listennummern sind nicht enthalten.
GT_NOHIDDENTEXT
 Ausgeblendeter Text ist nicht im abgerufenen Text enthalten.
GT_RAWTEXT
 Text wird genau so abgerufen, wie er im Arbeitsspeicher angezeigt wird. Dazu gehören spezielle Strukturzeichen für Tabellenzeilen- und Zelltrennzeichen (siehe Hinweise zu EM_INSERTTABLE) sowie mathematische Objekttrennzeichen (Starttrennzeichen U+FDD0, Argumenttrennzeichen U+FDEE und Endtrennzeichen U+FDDF) und Objektmarkierungen (U+FFFC). Dadurch wird die Zeichenpositionsausrichtung zwischen dem abgerufenen Text und dem Text im Arbeitsspeicher beibehalten.
GT_SELECTION
 Rufen Sie den Text für die aktuelle Auswahl ab.
GT_USECRLF
 Übersetzen Sie beim Kopieren von Text jede CR in eine CR/LF.

codepage

Typ: UINT

Codepage, die in der Übersetzung verwendet wird. Es ist CP_ACP für DIE ANSI-Codepage und 1200 für Unicode.

lpDefaultChar

Typ: LPCSTR

Das Zeichen, das verwendet wird, wenn ein Breitzeichen in der angegebenen Codepage nicht dargestellt werden kann. Sie wird nur verwendet, wenn die Codepage nicht 1200 (Unicode) ist. Wenn dieser Member NULL ist, wird ein Systemstandardwert verwendet.

lpUsedDefChar

Typ: LPBOOL

Ein Flag, das angibt, ob das Standardzeichen (lpDefaultChar) verwendet wurde. Dieser Member wird nur verwendet, wenn die Codepage nicht 1200 oder CP_UTF8 (Unicode) ist. Das Flag ist TRUE , wenn ein oder mehrere Breitzeichen in der Quellzeichenfolge in der angegebenen Codepage nicht dargestellt werden können. Andernfalls ist das Flag FALSE. Dieser Member kann NULL sein.

Hinweise

Die EM_GETTEXTEX Meldung ist schneller, wenn sowohl lpDefaultChar als auch lpUsedDefCharNULL sind.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile richedit.h

Weitere Informationen

EM_GETTEXTEX