ITfLangBarMgr

COM

IID87955690-e627-11d2-8ddb-00105a2799b5継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

ITfLangBarMgr インターフェースは TSF マネージャーが実装し、テキストサービスがイベントシンクの通知を管理し、フローティング言語バーの表示設定を構成するために使用します。インターフェース ID は IID_ITfLangBarMgr です。

メソッド 9

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

vtbl 3 HRESULT AdviseEventSink(ITfLangBarEventSink* pSink, HWND hwnd, DWORD dwFlags, DWORD* pdwCookie)

ITfLangBarMgr::AdviseEventSink メソッドは、言語バーのイベントをシンクに通知するよう登録します。

pSink	ITfLangBarEventSink*	in	イベントの通知を受け取るシンクオブジェクト。
hwnd	HWND	in	予約済みです。NULL を指定する必要があります。
dwFlags	DWORD	in	予約済みです。0 を指定する必要があります。
pdwCookie	DWORD*	in	接続の識別子へのポインター。

戻り値

このメソッドは次のいずれかの値を返すことがあります。

値	説明
S_OK	メソッドは成功しました。
E_INVALIDARG	pSink が無効です。
E_FAIL	不特定のエラーが発生しました。

解説(Remarks)

pdwCookie は識別子を受け取ります。この識別子は、イベントシンクが不要になったときに ITfLangBarMgr::UnadviseEventSink に渡します。

vtbl 4 HRESULT UnadviseEventSink(DWORD dwCookie)

ITfLangBarMgr::UnadviseEventSink メソッド

dwCookie

DWORD

アンインストールするアドバイズイベントシンクを識別する DWORD 値。この値は、以前の ITfLangBarMgr::AdviseEventSink の呼び出しで提供されます。

戻り値

このメソッドは次のいずれかの値を返すことがあります。

値	説明
S_OK	メソッドは成功しました。
E_FAIL	不特定のエラーが発生しました。

vtbl 5 HRESULT GetThreadMarshalInterface(DWORD dwThreadId, DWORD dwType, GUID* riid, IUnknown** ppunk)

ITfLangBarMgr::GetThreadMarshalInterface メソッド

dwThreadId	DWORD	in	対象スレッドの ID を指定する。
dwType	DWORD	in	取得するマーシャリングインターフェイスの種類を指定する。
riid	GUID*	in	要求するインターフェイスの識別子(IID)へのポインタである。
ppunk	IUnknown**	out	取得したマーシャリングインターフェイスへのポインタを受け取る出力ポインタである。

戻り値

このメソッドは値を返しません。

vtbl 6 HRESULT GetThreadLangBarItemMgr(DWORD dwThreadId, ITfLangBarItemMgr** pplbi, DWORD* pdwThreadid)

ITfLangBarMgr::GetThreadLangBarItemMgr メソッド

dwThreadId	DWORD	in	対象スレッドの ID を指定する。
pplbi	ITfLangBarItemMgr**	out	取得したスレッドの言語バー項目マネージャ ITfLangBarItemMgr へのポインタを受け取る出力ポインタである。
pdwThreadid	DWORD*	out	実際に対象となったスレッドの ID を受け取る出力ポインタである。

戻り値

このメソッドは値を返しません。

vtbl 7 HRESULT GetInputProcessorProfiles(DWORD dwThreadId, ITfInputProcessorProfiles** ppaip, DWORD* pdwThreadid)

ITfLangBarMgr::GetInputProcessorProfiles メソッド

dwThreadId	DWORD	in	対象スレッドの ID を指定する。
ppaip	ITfInputProcessorProfiles**	out	取得した入力プロセッサプロファイル ITfInputProcessorProfiles へのポインタを受け取る出力ポインタである。
pdwThreadid	DWORD*	out	実際に対象となったスレッドの ID を受け取る出力ポインタである。

戻り値

このメソッドが成功すると、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

vtbl 8 HRESULT RestoreLastFocus(DWORD* pdwThreadId, BOOL fPrev)

ITfLangBarMgr::RestoreLastFocus メソッド

pdwThreadId	DWORD*	out	フォーカスを復元したスレッドの ID を受け取る出力ポインタである。
fPrev	BOOL	in	1 つ前のフォーカスへ復元するかどうかを指定する。

戻り値

このメソッドは値を返しません。

vtbl 9 HRESULT SetModalInput(ITfLangBarEventSink* pSink, DWORD dwThreadId, DWORD dwFlags)

ITfLangBarMgr::SetModalInput メソッド

pSink	ITfLangBarEventSink*	in	モーダル入力中のイベントを受け取るイベントシンクへのポインタである。
dwThreadId	DWORD	in	使用しないでください。
dwFlags	DWORD	in	使用しないでください。

戻り値

このメソッドは値を返しません。

vtbl 10 HRESULT ShowFloating(DWORD dwFlags)

ITfLangBarMgr::ShowFloating メソッド

dwFlags

DWORD

言語バーの表示設定を指定します。

値	意味
TF_SFT_SHOWNORMAL	言語バーをフローティングウィンドウとして表示します。この定数は、TF_SFT_DOCK、TF_SFT_MINIMIZED、TF_SFT_HIDDEN、TF_SFT_DESKBAND の各定数と組み合わせることはできません。
TF_SFT_DOCK	Windows Vista 以降では非推奨です。言語バーを専用のタスクペインにドッキングします。この定数は、TF_SFT_SHOWNORMAL、TF_SFT_MINIMIZED、TF_SFT_HIDDEN、TF_SFT_DESKBAND の各定数と組み合わせることはできません。Windows XP でのみ使用できます。
TF_SFT_MINIMIZED	Windows Vista 以降では非推奨です。言語バーをシステムトレイ内の 1 つのアイコンとして表示します。この定数は、TF_SFT_SHOWNORMAL、TF_SFT_DOCK、TF_SFT_HIDDEN、TF_SFT_DESKBAND の各定数と組み合わせることはできません。
TF_SFT_HIDDEN	言語バーを非表示にします。この定数は、TF_SFT_SHOWNORMAL、TF_SFT_DOCK、TF_SFT_MINIMIZED、TF_SFT_DESKBAND の各定数と組み合わせることはできません。
TF_SFT_NOTRANSPARENCY	言語バーを不透明にします。
TF_SFT_LOWTRANSPARENCY	言語バーを部分的に透明にします。Windows 2000 以降でのみ使用できます。
TF_SFT_HIGHTRANSPARENCY	言語バーの透明度を高くします。Windows 2000 以降でのみ使用できます。
TF_SFT_LABELS	言語バーのアイコンの隣にテキストラベルを表示します。
TF_SFT_NOLABELS	言語バーのアイコンのテキストラベルを非表示にします。
TF_SFT_EXTRAICONSONMINIMIZED	言語バーが最小化されているときに、テキストサービスのアイコンをタスクバーに表示します。
TF_SFT_NOEXTRAICONSONMINIMIZED	言語バーが最小化されているときに、テキストサービスのアイコンをタスクバーに表示しません。
TF_SFT_DESKBAND	言語バーをシステムのタスクバーにドッキングします。この定数は、TF_SFT_SHOWNORMAL、TF_SFT_DOCK、TF_SFT_MINIMIZED、TF_SFT_HIDDEN の各定数と組み合わせることはできません。Windows XP でのみ使用できます。

戻り値

このメソッドは次のいずれかの値を返すことがあります。

値	説明
S_OK	メソッドは成功しました。
E_FAIL	不特定のエラーが発生しました。
E_INVALIDARG	dwFlags が無効です。

vtbl 11 HRESULT GetShowFloatingStatus(DWORD* pdwFlags)

ITfLangBarMgr::GetShowFloatingStatus メソッド

pdwFlags

DWORD*

out

現在の言語バーの表示設定を示します。ビットフィールドの値の一覧については、ITfLangBarMgr::ShowFloating を参照してください。

戻り値

このメソッドは次のいずれかの値を返すことがあります。

値	説明
S_OK	メソッドは成功しました。
E_INVALIDARG	pdwFlags が無効です。
E_FAIL	不特定のエラーが発生しました。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

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

出力引数:

#define global IID_ITfLangBarMgr "{87955690-E627-11D2-8DDB-00105A2799B5}"
#usecom global ITfLangBarMgr IID_ITfLangBarMgr "{}"
#comfunc global ITfLangBarMgr_AdviseEventSink            3 sptr,sptr,int,var
#comfunc global ITfLangBarMgr_UnadviseEventSink          4 int
#comfunc global ITfLangBarMgr_GetThreadMarshalInterface  5 int,int,var,sptr
#comfunc global ITfLangBarMgr_GetThreadLangBarItemMgr    6 int,sptr,var
#comfunc global ITfLangBarMgr_GetInputProcessorProfiles  7 int,sptr,var
#comfunc global ITfLangBarMgr_RestoreLastFocus           8 var,int
#comfunc global ITfLangBarMgr_SetModalInput              9 sptr,int,int
#comfunc global ITfLangBarMgr_ShowFloating               10 int
#comfunc global ITfLangBarMgr_GetShowFloatingStatus      11 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_ITfLangBarMgr "{87955690-E627-11D2-8DDB-00105A2799B5}"
#usecom global ITfLangBarMgr IID_ITfLangBarMgr "{}"
#comfunc global ITfLangBarMgr_AdviseEventSink            3 sptr,sptr,int,sptr
#comfunc global ITfLangBarMgr_UnadviseEventSink          4 int
#comfunc global ITfLangBarMgr_GetThreadMarshalInterface  5 int,int,sptr,sptr
#comfunc global ITfLangBarMgr_GetThreadLangBarItemMgr    6 int,sptr,sptr
#comfunc global ITfLangBarMgr_GetInputProcessorProfiles  7 int,sptr,sptr
#comfunc global ITfLangBarMgr_RestoreLastFocus           8 sptr,int
#comfunc global ITfLangBarMgr_SetModalInput              9 sptr,int,int
#comfunc global ITfLangBarMgr_ShowFloating               10 int
#comfunc global ITfLangBarMgr_GetShowFloatingStatus      11 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。