iTfRange：：GetText 方法 (msctf.h)

  • 项目

ITfRange：：GetText 方法获取此文本范围涵盖的内容。

语法

HRESULT GetText(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [out] WCHAR        *pchText,
  [in]  ULONG        cchMax,
  [out] ULONG        *pcch
);

parameters

[in] ec

用于标识从 ITfDocumentMgr：：CreateContext 或 ITfEditSession：:D oEditSession 获取的编辑上下文的编辑 Cookie。

[in] dwFlags

指定可选行为的位字段。

值 含义
TF_TF_MOVESTART
 范围的起始定位点将提前到返回最后一个字符之后的位置。
TF_TF_IGNOREEND
 方法尝试使用最大字符数填充 pchText ，而不是在范围的结束定位点占用的位置停止复制。

[out] pchText

指向缓冲区的指针，用于接收区域中的文本。

[in] cchMax

文本缓冲区的最大大小。

[out] pcch

指向 ULONG 的指针，该 ULONG 表示写入 pchText 文本缓冲区的字符数。

返回值

此方法可以返回其中一个值。

值 说明
S_OK
 方法成功。
E_FAIL
 发生了未指定的错误。
E_INVALIDARG
 一个或多个参数无效。
TF_E_NOLOCK
 ec 参数的值是无效的 Cookie，或者调用方没有只读锁。

要求

   
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 msctf.h
DLL Msctf.dll
可再发行组件 Windows 2000 专业版上的 TSF 1.0

另请参阅

ITfDocumentMgr：：CreateContext

ITfEditSession：:D oEditSession

ITfRange

TF_TF_* 常量

文本存储