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。

注解

lpDefaultCharlpUsedDefChar 均为 NULL 时,EM_GETTEXTEX消息速度更快。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
标头 richedit.h

另请参阅

EM_GETTEXTEX