IOleControlSite::TranslateAccelerator メソッド (ocidl.h)

  • [アーティクル]

処理のためにコントロール サイトにキーストロークを渡します。

構文

HRESULT TranslateAccelerator(
  [in] MSG   *pMsg,
  [in] DWORD grfModifiers
);

パラメーター

[in] pMsg

処理するキーストロークを記述する MSG 構造体へのポインター。

[in] grfModifiers

コントロール、Alt、および Shift キーの状態を示すフラグ。 フラグの値には、任意の有効な KEYMODIFIERS 列挙値を指定できます。

戻り値

このメソッドは、次の値を返すことができます。

リターン コード 説明
S_OK
 コンテナーがメッセージを処理しました。
S_FALSE
 コンテナーがメッセージを処理しませんでした。 この値は、E_NOTIMPL以外のすべてのエラー ケースでも返す必要があります。
E_NOTIMPL
 コンテナーはアクセラレータのサポートを実装していません。

注釈

このメソッドは、UI アクティブにできるコントロールによって呼び出されます。 このような場合、コントロールは、通常の OLE 複合ドキュメントルールに従って、 最初に IOleInPlaceActiveObject::TranslateAccelerator を介してすべてのキーストロークを処理できます。 このメソッド内では、コントロールは IOleControlSite::TranslateAccelerator を呼び出し、戻り値を使用して処理が行われたかどうかを判断することで、コンテナーに最初に処理する特定のメッセージを提供できます。 それ以外の場合、コントロールは常に最初にメッセージを処理します。 コントロールがキーストロークをアクセラレータとして使用しない場合は、このメソッドを使用してキーストロークをコンテナーに渡します。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー ocidl.h

こちらもご覧ください

IOleControlSite

IOleInPlaceActiveObject::TranslateAccelerator