IPreviewHandlerFrame::GetWindowContext メソッド (shobjidl_core.h)

  • [アーティクル]

プレビュー ホストのキーボード ショートカットの一覧を取得します。

構文

HRESULT GetWindowContext(
  [out] PREVIEWHANDLERFRAMEINFO *pinfo
);

パラメーター

[out] pinfo

型: PREVIEWHANDLERFRAMEINFO*

アクセラレータ テーブル情報を受け取る PREVIEWHANDLERFRAMEINFO 構造体へのポインター。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

アクセラレータ テーブルは、キーボード ショートカットと、ホストが実行する必要があるコマンドの一覧です。 最適化として、プレビュー ハンドラーは受け取ったキーストロークを確認し、アクセラレータ テーブルに対してチェックして、ホストがそれらに関心があるかどうかを確認し、必要に応じて、構造体内のコマンドを無視して転送できます。 IPreviewHandlerFrame::GetWindowContext から返されるアクセラレータ テーブルには、キーストロークのみが含まれており、有効なコマンド エントリは含まれません。 プレビュー ハンドラーでは、この最適化をスキップし、キーストロークごとに IPreviewHandlerFrame::TranslateAccelerator を呼び出すだけです。 プレビュー ハンドラーが破棄されると、 DestroyAcceleratorTable 関数を使用してアクセラレータ テーブルを解放する必要があります。

このメソッドは、プレビュー ハンドラーが SetSite を呼び出し、結果が後でプレビュー ハンドラーによって使用されるようにキャッシュされている時点で呼び出す必要があります。 このメソッドは、低整合性モードで実行されているプレビュー ハンドラーでは呼び出すことができません。 これらのプレビュー ハンドラーでは、キーストロークごとに常に IPreviewHandlerFrame::TranslateAccelerator を呼び出す必要があります。

要件

要件 値
サポートされている最小のクライアント Windows Vista、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー shobjidl_core.h (Shobjidl.h を含む)
再頒布可能パッケージ Windows Search 4 以降

こちらもご覧ください

IPreviewHandlerFrame

IPreviewHandlerFrame::TranslateAccelerator