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

ITfCandidateListUIElement

COM
IIDea1ea138-19df-11d7-a6d2-00065b84435c継承元ITfUIElement自前メソッド開始 vtbl7

メソッド 8

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

vtbl 7 HRESULT GetUpdatedFlags(DWORD* pdwFlags)
pdwFlagsDWORD*out候補リストのどの部分が更新されたかを示すフラグ (TF_CLUIE_*) を受け取る。
vtbl 8 HRESULT GetDocumentMgr(ITfDocumentMgr** ppdim)
ppdimITfDocumentMgr**outこの候補リストに関連付けられたドキュメントマネージャ ITfDocumentMgr へのポインタを受け取る。
vtbl 9 HRESULT GetCount(DWORD* puCount)
puCountDWORD*out候補リスト内の候補の総数を受け取る。
vtbl 10 HRESULT GetSelection(DWORD* puIndex)
puIndexDWORD*out現在選択されている候補のインデックスを受け取る。
vtbl 11 HRESULT GetString(DWORD uIndex, LPWSTR* pstr)
uIndexDWORDin文字列を取得する候補のインデックスを指定する。
pstrLPWSTR*out指定したインデックスの候補文字列を受け取る。CoTaskMemFree で解放する必要がある。
vtbl 12 HRESULT GetPageIndex(DWORD* pIndex, DWORD uSize, DWORD* puPageCnt)
pIndexDWORD*outoptional各ページの先頭候補インデックスを格納する配列を受け取る。NULL を指定すると必要なサイズのみを取得する。
uSizeDWORDinpIndex 配列の要素数を指定する。
puPageCntDWORD*outページの総数を受け取る。
vtbl 13 HRESULT SetPageIndex(DWORD* pIndex, DWORD uPageCnt)
pIndexDWORD*in各ページの先頭候補インデックスを格納した配列へのポインタである。
uPageCntDWORDinpIndex 配列内のページ数を指定する。
vtbl 14 HRESULT GetCurrentPage(DWORD* puPage)
puPageDWORD*out現在表示されているページのインデックスを受け取る。

HSP用 COM定義

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

出力引数:
#define global IID_ITfCandidateListUIElement "{EA1EA138-19DF-11D7-A6D2-00065B84435C}"
#usecom global ITfCandidateListUIElement IID_ITfCandidateListUIElement "{}"
#comfunc global ITfCandidateListUIElement_GetUpdatedFlags  7 var
#comfunc global ITfCandidateListUIElement_GetDocumentMgr   8 sptr
#comfunc global ITfCandidateListUIElement_GetCount         9 var
#comfunc global ITfCandidateListUIElement_GetSelection     10 var
#comfunc global ITfCandidateListUIElement_GetString        11 int,var
#comfunc global ITfCandidateListUIElement_GetPageIndex     12 var,int,var
#comfunc global ITfCandidateListUIElement_SetPageIndex     13 var,int
#comfunc global ITfCandidateListUIElement_GetCurrentPage   14 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。