ITfEditRecord::GetTextAndPropertyUpdates 方法 (msctf.h)

获取一个枚举器,其中包含范围对象的集合,这些对象涵盖在编辑会话期间更改的指定属性和/或文本。

语法

HRESULT GetTextAndPropertyUpdates(
  [in]  DWORD         dwFlags,
  [in]  const GUID    **prgProperties,
  [in]  ULONG         cProperties,
  [out] IEnumTfRanges **ppEnum
);

parameters

[in] dwFlags

包含以下值的组合,这些值指定此方法的行为。

含义
0
指定方法将获取范围对象的集合,这些对象涵盖编辑会话期间更改的指定属性。 prgProperties 不能为 NULLcProperties 必须大于零。
TF_GTP_INCL_TEXT
指定 方法将获取范围对象的集合,这些对象涵盖编辑会话期间更改的文本。

[in] prgProperties

指向 GUID 值数组的指针,这些值标识要搜索其更改的属性。 此方法搜索在编辑会话期间更改的属性,如果属性包含在此数组中,则包含更改的属性的范围对象将添加到 ppEnum

此数组的大小必须至少为 cProperties 元素。

如果 dwFlags 包含TF_GTP_INCL_TEXT且 cProperties 为零,则忽略此参数。

[in] cProperties

指定 prgProperties 数组中的元素数。

如果 dwFlags 包含TF_GTP_INCL_TEXT,则此参数可以为零。 这表示未获取任何属性更改。

[out] ppEnum

指向接收枚举器对象的 IEnumTfRanges 接口指针的指针。

返回值

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

说明
S_OK
方法成功。
E_INVALIDARG
一个或多个参数无效。
E_OUTOFMEMORY
内存分配失败。

要求

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

另请参阅

IEnumTfRanges

ITfEditRecord