Win32 API 日本語リファレンス
ホーム › UI.TextServices › ITfUIElement

ITfUIElement

COM
📘 Microsoft Learn (日本語) · English
IIDea1ea137-19df-11d7-a6d2-00065b84435c継承元IUnknown自前メソッド開始 vtbl3

メソッド 4

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetDescription(LPWSTR* pbstrDescription)
pbstrDescriptionLPWSTR*outUI 要素の説明文字列を受け取る。呼び出し側が SysFreeString で解放する必要がある。
vtbl 4 HRESULT GetGUID(GUID* pguid)
pguidGUID*outこの UI 要素を識別する GUID を受け取る。
vtbl 5 HRESULT Show(BOOL bShow)
bShowBOOLinUI 要素を表示する場合は TRUE、非表示にする場合は FALSE を指定する。
vtbl 6 HRESULT IsShown(BOOL* pbShow)
pbShowBOOL*outUI 要素が表示されている場合に TRUE を受け取る。

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_ITfUIElement "{EA1EA137-19DF-11D7-A6D2-00065B84435C}"
#usecom global ITfUIElement IID_ITfUIElement "{}"
#comfunc global ITfUIElement_GetDescription  3 var
#comfunc global ITfUIElement_GetGUID         4 var
#comfunc global ITfUIElement_Show            5 int
#comfunc global ITfUIElement_IsShown         6 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。