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) 時，才會使用此成員。 如果來源字串中的一或多個寬字元無法在指定的代碼頁中表示，則旗標為 TRUE 。 否則，旗標為 FALSE。 這個成員可以是 NULL。

備註

當 lpDefaultChar 和 lpUsedDefChar 都是 NULL 時，EM_GETTEXTEX訊息會更快。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	richedit.h

另請參閱

EM_GETTEXTEX