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

ITfConfigureSystemKeystrokeFeed

COM
IID0d2c969a-bc9c-437c-84ee-951c49b1a764継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

ITfConfigureSystemKeystrokeFeed インターフェイスは、キーストロークの処理を有効または無効にするために TSF マネージャーによって実装されます。

メソッド 2

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

vtbl 3 HRESULT DisableSystemKeystrokeFeed()

ITfConfigureSystemKeystrokeFeed::DisableSystemKeystrokeFeed メソッド

戻り値

このメソッドは次のいずれかの値を返します。

説明
S_OK
メソッドは成功しました。

解説(Remarks)

既定では、TSF マネージャーはキーストロークを処理してテキストサービスに渡します。アプリケーションはこのメソッドを呼び出すことでこれを抑止できます。通常、このメソッドは、メニューが表示されているときなど、テキストサービスへの入力が適切でない場合に呼び出します。

このメソッドの呼び出しは累積されるため、このメソッドを呼び出すたびに、後で ITfConfigureSystemKeystrokeFeed::EnableSystemKeystrokeFeed を呼び出す必要があります。

vtbl 4 HRESULT EnableSystemKeystrokeFeed()

ITfConfigureSystemKeystrokeFeed::EnableSystemKeystrokeFeed メソッド

戻り値

このメソッドは次のいずれかの値を返します。

説明
S_OK
メソッドは成功しました。
E_UNEXPECTED
対応する DisableSystemKeystrokeFeed の呼び出しがありませんでした。

解説(Remarks)

既定では、TSF マネージャーはキーストロークを処理してテキストサービスに渡します。アプリケーションは DisableSystemKeystrokeFeed を呼び出すことでこれを抑止できます。

DisableSystemKeystrokeFeed の呼び出しは累積されるため、DisableSystemKeystrokeFeed を呼び出すたびに、後で EnableSystemKeystrokeFeed を呼び出す必要があります。DisableSystemKeystrokeFeed が複数回呼び出されている場合、EnableSystemKeystrokeFeed を 1 回呼び出してもキーストロークの処理は有効になりません。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_ITfConfigureSystemKeystrokeFeed "{0D2C969A-BC9C-437C-84EE-951C49B1A764}"
#usecom global ITfConfigureSystemKeystrokeFeed IID_ITfConfigureSystemKeystrokeFeed "{}"
#comfunc global ITfConfigureSystemKeystrokeFeed_DisableSystemKeystrokeFeed  3
#comfunc global ITfConfigureSystemKeystrokeFeed_EnableSystemKeystrokeFeed   4
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。