GETTEXTEX 構造体 (richedit.h)

  • [アーティクル]

リッチ エディット コントロールからテキストを取得する際に使用される情報が含まれます。 この構造体は、EM_GETTEXTEX メッセージと共 に 使用されます。

構文

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

メンバー

cb

型: DWORD

取得したテキストの格納に使用されるバッファーのサイズ (バイト単位)。

flags

型: DWORD

テキスト操作を指定する値。 このメンバーには、次のいずれかの値を指定できます。

値 意味
GT_DEFAULT
 すべてのテキストは、次の条件に従って取得されます。
  • キャリッジ リターン (U+000D) は CRLF (U+000D U+000A) に変換されません。
  • テーブルと数式オブジェクトの構造体の文字は削除されます ( GT_RAWTEXTを参照)。
  • 非表示のテキストが含まれています。
  • リスト番号は含まれません。
GT_NOHIDDENTEXT
 非表示のテキストは、取得したテキストには含まれません。
GT_RAWTEXT
 テキストは、メモリに表示されるとおりに取得されます。 これには、テーブル行区切り記号とセル区切り記号の特殊な構造文字 ( 「EM_INSERTTABLEの解説」を参照)、および数学オブジェクト区切り記号 (開始区切り記号 U+FDD0、引数区切り記号 U+FDEE、終了区切り記号 U+FDDF) とオブジェクト マーカー (U+FFFC) が含まれます。 これにより、取得したテキストとメモリ内のテキストとの間の文字位置の配置が維持されます。
GT_SELECTION
 現在の選択範囲のテキストを取得します。
GT_USECRLF
 テキストをコピーするときは、各 CR を CR/LF に変換します。

codepage

型: UINT

翻訳で使用されるコード ページ。 ANSI コード ページの 場合は CP_ACP 、Unicode の場合は 1200 です。

lpDefaultChar

種類: LPCSTR

指定したコード ページでワイド文字を表すことができない場合に使用される文字。 コード ページが 1200 (Unicode) でない 場合にのみ使用されます。 このメンバーが NULL の場合は、システムの既定値が使用されます。

lpUsedDefChar

種類: LPBOOL

既定の文字 (lpDefaultChar) が使用されたかどうかを示すフラグ。 このメンバーは、コード ページが 1200 または CP_UTF8 (Unicode) でない場合にのみ使用されます。 指定したコード ページでソース文字列内の 1 つ以上のワイド文字を表すことができない場合、フラグは TRUE です。 それ以外の場合、フラグは FALSE です。 このメンバーには NULL を指定できます。

注釈

lpDefaultChar と lpUsedDefChar の両方が NULL の場合、EM_GETTEXTEX メッセージの方が高速です。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header richedit.h

こちらもご覧ください

EM_GETTEXTEX