iTfUIElementSink：：BeginUIElement 方法 (msctf.h)

ITfUIElementSink：：BeginUIElement 方法在 UIElement 启动时调用。 此接收器可让文本服务绘制或不绘制 UI 元素。

语法

HRESULT BeginUIElement(
  [in] DWORD dwUIElementId,
       BOOL  *pbShow
);

参数

[in] dwUIElementId

[in]已启动的 UIElement 的 ID。

pbShow

[in， out]如果应用程序不绘制 UIElement 内容，并且文本服务绘制其原始 UI 内容，则返回 true 。 如果应用程序绘制 UIElement 的内容并停止文本服务绘制它，则返回 false 。 应用程序可以使用 ITfUIElementMgr：：GetUIElement 获取 ITfUIElement 接口，并且可以评估它是否可以使用 IID_ITfCandidateListUIElement 或其他 UIElement 接口通过 QI 处理 UIElement。 如果应用程序未知或无法处理，则始终可以返回 FALSE 。 在这种情况下，文本服务不会在屏幕上显示任何额外的 UI。 对于某些全屏应用程序，这是一种好方法。 或者，应用程序可以返回 TRUE ，以在某些特定或未知的 UI 上使用 TextService 的 UI。

返回值

TSF 管理器忽略此方法的返回值。

值	说明
S_OK	方法成功。
E_FAIL	发生了未指定的错误。

要求

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