最終更新日 2024-09-25

ダイアログ - 選択メニューダイアログ

複数のメニューから選択するタイプのダイアログを表示するAPIです。

大小関わらず、自作の独自イベントなどで利用することになるでしょう。

PICTURE

int 選択メニューダイアログ表示(文字列リスト型 文字列リスト, int Ｘ座標, int Ｙ座標 )

メニューの項目数は最大で「３６」個までである。
それを越えた時は、ダイアログ自体表示しない。 又、１つもメニュー項目がない場合もダイアログを表示しない。

  文字列リスト型 myList;

  myList.push_back("あああ");
  myList.push_back("いいいい");
  myList.push_back("ううううう");

  int result = 選択メニューダイアログ表示(myList);

  // メニューダイアログで具体的な項目が選択されなかった場合0xFFFFが返ってくる。
  if ( result == 0xFFFF ) {
    デバッグ出力 << "メニューはどの項目も選択されずキャンセルして閉じられました。";
  }

    // 配列にアクセスするので、必ず範囲内に収まっているかチェックする。
  if ( result != 0xFFFF ) {
    デバッグ出力 << "メニュー配列" << result << "が選択されました。\n上から" << result+1 << "番目です。" << endl;
    デバッグ出力 << "メニュー上の文字列" << myList[result] << "が選択されました!!";
  }

文字列リスト型 の実態は vector<string> であるため、
固定的な文字列のリストである場合には、一気に初期化の段階でリストにしたほうがわかりやすいだろう。 

  文字列リスト型 myList{
	"あああ",
	"いいいい",
	"ううううう"
  };

事前にはメニュー項目の数や内容が定まらないため、１つ１つ push_back してゆくようなシーンもある まどろっこしく感じられるかもしれないが、これによって、「プログラムを組む段階では事前に知っていないメニュー」を作ることが可能だ。

例えば次のようなものである。

自分の麾下の軍団長と大名自身をリスト化して選択する 
void カスタム::On_プレイヤ担当ターン《メイン画面》() {

  文字列リスト型 myList;
  for ( int iBushouID=0; iBushouID < 最大数::武将情報::配列数; iBushouID++ ) {
    // 武将は、今ターンがまわってる大名に所属してて…
    if ( p武将情報[iBushouID].所属大名【大名番号】 == pターン情報.現在のターン【大名番号】 ) {
      // 大名かもしくは軍団長ならば
      if ( p武将戸籍情報[iBushouID].状態 == 状態::大名 || p武将戸籍情報[iBushouID].状態 == 状態::軍団長 ) {
        // メニューリストに入れる。
        myList.push_back(Get_名字(iBushouID)+Get_名前(iBushouID));
      }
    }
  }

  int result = 選択メニューダイアログ表示(myList);

  // 配列にアクセスするので、必ず範囲内に収まっているかチェックする。
  if ( result != 0xFFFF ) {
    デバッグ出力 << "メニュー配列" << result << "が選択されました。\n上から" << result+1 << "番目です。" << endl;
    デバッグ出力 << "メニュー上の文字列" << myList[result] << "が選択されました!!";
  }
}

メニューの位置を指定することが可能

座標を指定しない限りは画面の中央に表示されます。

文字列リスト型 list;
list.push_back("あああああああああああああああああああああああ");
list.push_back("い");
list.push_back("う");
int result = 選択メニューダイアログ表示(list);

PICTURE

通常はこのように座標は指定せず、画面の中央に出すのがよいとは思いますが、
ＸとＹの位置をあえて指定することも可能です。

	文字列リスト型 myList{
		"あああ",
		"いいいい",
		"ううううう"
	};

	int result = 選択メニューダイアログ表示(myList, 300, 200);

より詳細を知るには...

「選択メニューダイアログ」に関する主な所は以上となります。 詳しくは「ダイアログ情報型.h」を参照してください。