共用方式為

ITfUIElementSink：：BeginUIElement 方法 (msctf.h)

  • 發行項

當 UIElement 啟動時，會呼叫 ITfUIElementSink：：BeginUIElement 方法。 這個接收可讓 textservice 繪製或不要繪製 UI 元素。

語法

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

參數

[in] dwUIElementId

[in]啟動的UIElement標識符。

pbShow

[in， out]如果應用程式未繪製UIElement內容，且文字服務會繪製其原始UI內容，則傳回 true 。 如果應用程式繪製 UIElement 的內容，並停止文字服務繪製它，則傳回 false 。 應用程式可以使用 ITfUIElementMgr：：GetUIElement 來取得 ITfUIElement 介面，而且可以透過 QI 搭配IID_ITfCandidateListUIElement或其他 UIElement 介面來評估它是否可以處理 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