CKeyboardManager クラス

[アーティクル]
08/09/2011

メインフレームウィンドウおよび子フレームウィンドウのショートカットキーのテーブルを管理します。

class CKeyboardManager : public CObject

メンバー

パブリックコンストラクター

[名前]	説明
CKeyboardManager::CKeyboardManager	CKeyboardManager オブジェクトを構築します。

パブリックメソッド

[名前]	説明
CKeyboardManager::CleanUp	ショートカットキーテーブルを消去します。
CKeyboardManager::FindDefaultAccelerator	指定されたコマンドおよびウィンドウの既定のショートカットキーを取得します。
CKeyboardManager::IsKeyHandled	キーがアクセラレータテーブルで処理されるかどうかを確認します。
CKeyboardManager::IsKeyPrintable	文字が印刷可能かどうかを示します。
CKeyboardManager::IsShowAllAccelerators	メニューにコマンドのすべてのショートカットキーが表示されるか、または既定のショートカットキーのみが表示されるかを示します。
CKeyboardManager::LoadState	Windows レジストリからショートカットキーのテーブルを読み込みます。
CKeyboardManager::ResetAll	アプリケーションリソースからショートカットキーの一覧を再読み込みします。
CKeyboardManager::SaveState	ショートカットキーの一覧を Windows レジストリに保存します。
CKeyboardManager::ShowAllAccelerators	フレームワークがすべてのコマンドのすべてのショートカットキーを表示するか、または各コマンドの 1 つのショートカットキーのみを表示するかを示します。このメソッドは、関連付けられたショートカットキーが 1 つしかないコマンドには影響を与えません。
CKeyboardManager::TranslateCharToUpper	文字を大文字レジスタに変換します。
CKeyboardManager::UpdateAccelTable	ショートカットキーテーブルを新しいショートカットキーテーブルで更新します。

解説

このクラスのメンバーを使用すると、ショートカットキーテーブルを Windows レジストリに保存して読み込んだり、テンプレートを使用してショートカットキーテーブルを更新したり、フレームウィンドウでコマンドの既定のショートカットキーを見つけることができます。加えて、CKeyboardManager オブジェクトを使用すると、ショートカットキーがユーザーに表示される方法を制御できます。

CKeyboardManager オブジェクトは手動で作成しないでください。アプリケーションのフレームワークによって自動的に作成されます。ただし、アプリケーションの初期化中には CWinAppEx::InitKeyboardManager を呼び出す必要があります。アプリケーションのキーボードマネージャーへのポインターを取得するには、CWinAppEx::GetKeyboardManager を呼び出します。

使用例

CKeyboardManager オブジェクトへのポインターを CWinAppEx クラスから取得する方法と、メニューコマンドに関連付けられたすべてのショートカットキーを表示する方法を次の例に示します。このコードスニペットは、「CustomPages サンプル:MFC ツールバーのカスタマイズ] ダイアログアプリケーション」の一部です。

    // The GetKeyboardManager method is inherited from the CWinAppEx class.
    CKeyboardManager* cKeyboardManager = GetKeyboardManager();
    cKeyboardManager->ShowAllAccelerators();