メニュー コマンド (C++)
次の表は、メニュー コマンドを選択したときに [プロパティ] ウィンドウに表示されるメニュー プロパティに従って編成されています。 リストはアルファベット順になっていますが、[プロパティ] ウィンドウではプロパティをカテゴリ別に表示することもできます。
プロパティ | 説明 |
---|---|
休憩 | 次のいずれかの値を指定します。 - [なし]: 中断なし。 これが既定です。 - [列]: 静的なメニューの場合は、この値を選択するとメニュー コマンドが新しい行に置かれます。 ショートカット メニューの場合は、この値を選択すると、列の区切りがない新しい列にメニュー コマンドが置かれます。 このプロパティを設定した場合に影響を受けるのは、メニュー エディター内のメニューの外観ではなく、実行時のメニューの外観だけです。 - [バー]: [列] と同じですが、ショートカット メニューの場合は、この値を選択すると新しい列と古い列が縦線で区切られます。 このプロパティを設定した場合に影響を受けるのは、メニュー エディター内のメニューの外観ではなく、実行時のメニューの外観だけです。 |
Caption | メニュー コマンドのラベルとなるテキスト (メニュー名)。 メニュー コマンドのキャプションのうちの 1 文字をニーモニック キーにするには、その文字の前にアンパサンド (&) を付けます。 |
オン | [True] を選択すると、メニュー コマンドが既定でオンになります。 ブール型です。 既定値は Falseです。 |
Enabled | [False]を選択すると、メニュー項目が無効になります。 |
淡色表示 | [True] を選択すると、メニュー コマンドが既定で淡色表示され、無効になります。 ブール型です。 既定値は Falseです。 |
ヘルプ | メニュー項目が右寄せになります。 既定値は Falseです。 たとえば、どの Windows アプリケーションでも、 [ヘルプ] メニュー コマンドは常に右端に表示されます。 このプロパティを設定したメニュー項目は、メニューの最後の右端に表示されます。 このプロパティはトップレベルの項目に適用されます。 |
ID | ヘッダー ファイルに定義されているシンボル。 値は、シンボル、整数、または二重引用符で囲まれた文字列です。 [プロパティ] ウィンドウ に選択用のドロップダウン リストが用意されていなくても、すべてのエディターで利用可能なシンボルを使用できます。 |
Popup | [True] を選択すると、メニュー コマンドがショートカット メニューになります。 ブール型です。 既定値は、メニュー バーのトップレベル メニューの場合は [True]、それ以外の場合は [False] です。 |
プロンプト | このメニュー コマンドを強調表示したときに、ステータス バーに表示されるテキスト。 このテキストは、メニュー コマンドと同じ識別子を持つストリング テーブルに置かれます。 このプロパティはどの種類のプロジェクトにも使用できますが、実行時の機能は MFC 固有です。 |
右から左へのレイアウト | 実行時にメニュー コマンドがメニュー バーで右寄せになります。 ブール型です。 既定値は Falseです。 |
右から左への順序 | インターフェイスがヘブライ語やアラビア語などの右から左に読む言語にローカライズされている場合、メニュー コマンドを右から左に表示できます。 |
Separator | [True] を選択すると、メニュー コマンドが区切り記号になります。 ブール型です。 既定値は Falseです。 |
メニュー コマンドを関連付ける
メニュー コマンドとキーボードの組み合わせで同じプログラム コマンドを発行したいと思うことはよくあります。 同じコマンドを発行するには、メニュー エディターを使用して、メニュー コマンドと、アプリケーションのアクセラレータ テーブル内のエントリに、同じリソース識別子を割り当てます。 次に、メニュー コマンドの キャプション を編集して、アクセラレータ キーの名前を表示します。
メニュー コマンドをアクセラレータ キーと関連付けるには
メニュー エディターで、目的のメニュー コマンドを選択します。
プロパティ ウィンドウで、アクセラレータ キーの名前を キャプション プロパティに追加します。
メニューのキャプションに続いて、タブ (\t) のエスケープ シーケンスを入力し、すべてのメニューのアクセラレータ キーが左揃えされるようにします。
修飾キー (Ctrl、Alt、または Shift)、に続いて正符号 (+) と、追加キーの名前、文字、またはシンボルを入力します。
たとえば、Ctrl+O を [ファイル] メニューの [開く] コマンドに割り当てるには、メニュー コマンドのキャプションを変更します。結果は次のテキストのようになります。
&Open...\tCtrl+O
メニュー エディターのメニュー コマンドは、入力する新しいキャプションを反映するよう更新されます。
アクセラレータ エディターで アクセラレータ テーブル エントリ を作成し、メニュー コマンドと同じ識別子をそれに割り当てます。 使用するキーの組み合わせは、覚えやすいものにしてください。
MFC アプリケーションでは、ユーザーが選択する各メニュー コマンドに対して、説明のテキストを表示できます。 説明のテキストを表示するには、[プロパティ] ウィンドウの [プロンプト] プロパティを使用し、各メニュー コマンドにテキスト文字列を割り当てます。 コマンドと同じ ID を持つ ストリング テーブル に文字列がある場合、MFC アプリケーションでは、ユーザーがマウス ポインターをメニュー項目の上に置くと、実行中のアプリケーションのステータス バーにこの文字列リソースが自動的に表示されます。
- MFC アプリケーションでメニュー コマンドをステータス バーのテキスト文字列に関連付けるには、メニュー エディターでメニュー コマンドを選択します。 [プロパティ] ウィンドウで、関連付けるステータス バーのテキストを [プロンプト] ボックスに入力します。
C++ プロジェクトで、メニューとメニュー コマンドにアクセス キー (ユーザーがキーボードを使ってメニューを選択できるようにするニーモニック) を割り当てることができます。
メニュー コマンドにアクセス (ショートカット) キーを割り当てるには、メニュー名やコマンド名の文字の前にアンパサンド (
&
) を入力し、対応するアクセス キーとしてその文字を指定します。たとえば、">ファイル" は、Microsoft Windows 用に記述されたアプリケーションの [ファイル] メニューのショートカット キーとして Alt+F を設定します。
メニュー項目は、文字の 1 つがショートカット キーに割り当てられている表示可能キューを提供します。 アンパーサンドに続く文字は、下線付きで表示されます (オペレーティング システムによって異なる)。
Note
メニューを右クリックし、[ニーモニックの確認] を選択して、メニューのすべてのアクセス キーが一意であることを確認してください。
要件
Win32