Windowsのアプリケーションでよく使われるメニューバーが利用できます。

注

ポップアップメニューは 「テキストウィジェット」−「ポップアップメニュー」 で解説します。

　画面最上段に横方向の帯としてメニューバーを設置できます。


　メニューバーの中には横方向にメニューボタンが並びます。

　・−−−−−−−−−−−−−−−−−−−−−−−−−−・
　｜｜ボタン１｜ボタン２｜・・・・・｜ボタンＮ｜　　　　｜
　・−−−−−−−−−−−−−−−−−−−−−−−−−−・
　｜　　　　　　　　　　　　　　　　　　　　　　　　　　｜
　｜　　　　　　　　　　　　　　　　　　　　　　　　　　｜
　｜　　　　　　　　　　　　　　　　　　　　　　　　　　｜
　｜　　　　　　　　　　　　　　　　　　　　　　　　　　｜
　｜　　　　　　　　　　　　　　　　　　　　　　　　　　｜
　｜　　　　　　　　　　　　　　　　　　　　　　　　　　｜
　・−−−−−−−−−−−−−−−−−−−−−−−−−−・

　メニューボタンを押したとき、ボタンウィジェットと同様にイベントを発生できますが、ボタンを押すとさらにサブメニューを表示する（この場合はイベントは発生しない）ことも出来ます。サブメニューの中でさらにサブメニューを出すことも可能です。




■メニューバーのＩＤの取得と有効化
       プログラム例：
　親となるウィンドウのＩＤを与えてメニューバーのＩＤを取得します。通常は上の例のように直ちに有効化します。
　他のウィジェットと異なり、メニューバーは有効化時に自動的に配置されるので、明に配置をおこなう必要はありません。

（記：厳密に言えば、単に 有効化 だけではメニューバーは現れず、後続してメニューボタンなどのメニュー項目を追加した段階で画面に現れます）

注

・「その他の配置手段」−「異なる配置手段の混在」 にて、並べ配置／座標配置／格子配置は混在できない旨の解説をしていますが、メニューバーは配置の概念を超えた存在であるためメニューバー以外のウィジェットとの組み合わせとしてはどの配置形態も使うことができます。
（本章でのサンプルプログラムでは他のウィジェットには並べ配置を使っています）

→ メニューバー以外のウィジェットを配置するにあたって、メニューバーを配置対象として加える必要はありません。

→ 感覚としては、ウィンドウの縦方向がメニューバーの分だけ短くなったようなものと言えます。

■メニュー項目としてボタンを追加
       プログラム例：
　メニューバーあるいはサブメニューの項目として、指定するテキストを持つボタンを追加します。
　追加されたボタンはメニューバー左端から右に向けて （サブメニューの場合は上から下に向けて） 並びます。
　メニューバー本体にボタンを追加する場合はメニーバーＩＤを、サブメニューとしてボタンを追加する場合はサブメニューのＩＤを指定します。
　ボタンが押された時に起動すべき処理単語の実行情報をその引数と共に指定できます。
　イベント引数は文字列で、 　　　　　「abc」を　・・ のように指定します。複数の引数は 　　　　　「abc def」を　・・ のように空白で区切って並べてください。引数に空白文字を含む場合には 　　　　　「"ab c" def」を　・・ のように指定してください。
　なお、引数（群）文字列末尾に \ 記号は付けられません。また、{ } 記号は使えるものの、開きと閉じでバランスが取れている必要があります。（アンバランスで使うとエラーを検出します）

■メニュー項目として区切りを追加
　メニューバーあるいはサブメニューの項目として区切り線を追加します。
　区切り線であっても１つの項目として数えます（項目番号があります）。




■メニュー項目としてチェックボタンを追加
       プログラム例：
       チェックボタンの表示例：

　メニュー項目としてチェックボタンを追加します。
　初期値で真偽を指定することで描画当初でのON/OFFを指定できます。
　ＩＤが返されますがチェック状態の参照のために使うので保存しておきます。


　チェックボタンを操作したときイベントは発生せず、内部状態の変化と見た目の変化だけが起きます。
　チェックボタンの状態を得たい場合には適切なタイミングで（何らかのイベント処理として）次に示す参照用の単語を実行してください。

■チェックボタンの値を参照
       プログラム例：
　チェックボタンの現在の状態を得ます。値は"0"または"1"の文字列です。
　この文字列はライブラリ内部に設置された文字列実体変数に格納され、そこを示す文字列情報として返されるため、続いて同じ単語を実行すると前回の値が上書きされてしまいます。
　したがって得た値を消費しないうちに再度実行する場合はユーザ側で設置した文字列実体変数に退避してください。




　ラジオボタンの 追加開始の手続きと、それに続く追加（複数繰り返し）の２段階に分かれます。

■メニュー項目としてラジオボタンを追加開始
       プログラム例：
       ラジオボタンの表示例：

　一連のラジオボタン群の描画に先立ちこの単語を１度だけ実行します。
　初期オンにすべき項目番号（１からの整数）を指定します。
　参照ＩＤが返されます。これは状態参照時に使うので整数変数に保存しておいてください。

注： ラジオボタンとチェックボタンのボタン部分が見た目上、同じで区別ができませんが、GUIエンジンの特性でありバグではありません（単独ウィジェットとしてのラジオボタンは本来の表示となります）。

■メニュー項目としてラジオボタンを追加
       プログラム例：
　指定したメニューにラジオボタンの項目を一つ追加します。ラジオボタンの数だけ繰り返し記述します。
　「値」は状態参照時に「どのボタンがオンか」を識別できるような文字列を指定します。これは表示には使われず、プログラム処理用です。上の例では「大」「中」「小」という文字列を指定していますが文字列であれば何でも構いません。

　ラジオボタンを操作したときにイベントは発生せず、内部状態の変化と見た目の変化だけが起きます。したがってラジオボタンの状態を得たい場合には適切なタイミングで（何らかのイベント処理として）次に示す参照用の単語を実行してください。

■ラジオボタンの選択を参照
       プログラム例：
　いま選択されているラジオボタンの選択値を文字列として得ます。返される値は、登録したラジオボタンの テキスト と 値 のペア のうち 値 のほうです。
　この参照値はライブラリ内部に設置された文字列実体変数に格納され、そこを示す文字列情報として返されるため、続いて同じ単語を実行すると前回の値が上書きされてしまいます。もし得た値を消費しないうちに再度実行する場合はユーザ側で設置した文字列実体変数に退避してください。
　参照値を変数に格納する場合の文字列実体変数の長さは、ボタン群の一番長い値（文字列）のバイト数を指定してください。先のプログラム例では値が「大」「中」「小」のいずれかなので、長さは２以上にすれば良いことになります。
　


　この先から「項目番号」という概念が出てきます。
　メニューバー、あるいはサブメニューについてはＩＤが割り当てられていますが、そのメニュー内に設置したボタンやチェックボックスなどの項目にはＩＤは無く、個々の項目に対して何らかの操作を行う場合は番号(１から数える)で指定することになります。たとえばメニューの先頭項目は１番です。




　サンプルプログラム "menu-detail.exe" を実行してみてください。
　メニー項目２をクリックするとサブメニューが表示されますが、項目１と項目２（いずれもボタン）にはショートカットとして Ctrl-c, Ctrl-d が割り当てられているのが分かります。

　次に主画面に戻り、Ctrl-c を押してみてください。「項目2のボタン1が押された」というモニタが表示され、項目２のボタン１の押下と同じ効果があることが分かります。
　以下ではこのショートカットの設定について説明します。

■バインドの概念
　ショートカットはオプションであり、この先で示す処理単語を使って明に指定します。
　メニュー項目に設置したショートカットにより特定のキー操作をメニュー項目のいずれかに結び付けることができますが、もう少し広い意味で、
　　　　　特定のイベントをある処理に結び付ける ことをバインドと呼びます。メニューバーにおいてはショートカットになりますが、たとえばテキストウィジェットの中でのキー操作（たとえばCtrl-z）に対してMindで書いた特定の処理（アンドゥ処理）を結び付けることもでき、そのような広い意味で結び付けの概念を「バインド」と呼びます。

■この番号のメニュー項目にショートカットを登録
       プログラム例：
　項目番号として０（ゼロ）を指定すると、直近のメニューボタン追加に対する項目と解釈されます。
　もし 「メニュー項目としてボタンを追加」 の直後、同項目に対してショートカットも併せて登録するのであれば、わざわざ項目番号を調べなくても、０を指定することで代用できます。
       プログラム例：（項目番号＝０の利用例）
　　　　　　　注：「メニュー項目としてボタンを追加」の直後でない
　　　　　　　　　個所で０番指定をおこなうと予期しない動作になったり
　　　　　　　　　エラー検出することがありますので注意してください

■この番号のメニュー項目にショートカットを表示
　「この番号のメニュー項目にショートカットを登録」にそっくりですが、ショートカットの対応が異なり、こちらではメニューに表示はするものの、バインドは行いません。
　サンプルプログラム "text-edit.exe" を起動してみてください。たとえば、メニューの「編集」を押すと 「切り取り」 に Ctrl-x というショートカットが割付られているのが見えます。
　しかし、Ctrl-x 打鍵での切り取り操作はテキストウィジェットのデフォルト動作であるためバインドする必要がありません。（バインド登録しなくてもCtrl-x 打鍵で切り取りが行われます）
　しかし、見た目としてはショートカットが登録されているかのような動作をするので、そのことは利用者に知らせる必要があります。つまり「メニュー表示上だけショートカットが存在するように見せるがバインドはおこなわない」・・という機能になります。



　キーシンボルとはキーボードのキー１つ１つを表すシンボルです。
　"c" とか "[" といったキーの刻印そのものに対応した１文字の文字列のほか、"Enter", "Esc" のような機能キーもあり、さらには "Ctrl-c" のように、Ctrlキー、Shiftキー、Altキー併用での打鍵を意味する書き方もあります。
　キーシンボルの表記にはルールがあります。 バインドとイベント名 に詳しい解説がありますので参照願います。



　一度表示したメニュー項目を抑制／活性したり削除するといった操作を行うことができます。

■この番号のメニュー項目を抑制／活性
       プログラム例：
　メニューＩＤと項目番号で指定した項目を抑制したり、活性（元に戻す）することができます。
　抑制した場合、その項目表示は薄字となりを押しても無反応となります。ショートカットも無視されます。

■この番号のメニュー項目を削除
       プログラム例：
　メニューＩＤと項目番号で指定した項目を削除します。
　項目にショートカットが割り当てられている場合、その割り当ても解除されます。
　項目を削除すると、それより先にある項目群は前方に詰められ、各項目の番号も１つずつ小さくなることに注意してください。
　たとえば、この処理単語を続けて実行し、
　　（誤）
　　　　２番の項目を削除
　　　　３番の項目を削除
をしようとしても正しく動作しません。なぜなら、２番の項目の削除によって元の３番が２番になっているため、「３番の項目を削除」をおこなうと元の４番が削除されてしまうからです。
　正しい書き方は、
　　（正）　（後述するがもっと良い方法がある）
　　　　２番の項目を削除
　　　　２番の項目を削除
となるのですが、これではまぎらわしいため、次に示す 「この範囲の番号のメニュー項目を削除」 を使うほうがスマートです。
　なお区切り線も１つの項目であるため、削除するときはこれも項目番号として数えてください。

■この範囲の番号のメニュー項目を削除
       プログラム例：
　指定した項目範囲のメニュー項目を削除します。後方にある項目群は前方に詰められ、新しく番号が振られます。

■メニューバー自体の削除
　メニューバーを削除したい場合はメニューバーのＩＤを指定して「ウィジェットを削除」を使ってください。
　サブメニュー（サブメニューの起点および子）を削除したい場合は、そのサブメニューの項目番号で「この番号のメニュー項目を削除」を使ってください。（サブメニュー下の全項目を削除する方法では子が消えるだけでサブメニュー起点は消えません）
　いずれの場合も、削除したメニューに関連するすべてのショートカット割り当ては解除されます。

■最後のメニュー項目番号を得る
　指定したメニューに含まれる総項目数を参照できます。
　メニューに最後に追加した項目番号を得る目的でも利用できます。