・押されたボタン情報はRESULT関数で取得できる。
・1:決定、-1:キャンセル、0:タイムアウト。
ダイアログに表示する文字列
・表示文字列は256文字まで
・表示文字列内にCHR$(10)かCHR$(13)があると改行する。
| 0 | 了解(デフォルト) |
| 1 | いいえ/はい |
| 2 | 戻る/次へ |
| 3 | 中止/決定 |
| 4 | 中止/実行 |
| 5 | 次へ |
・省略時は0を指定した事になる。
ダイアログ上部のキャプション欄に表示する文字列
・キャプション文字列が46文字より長い場合、46文字までしか表示されない。
・省略時、キャプション欄には"DIALOG"と表示される。
ダイアログを自動的に閉じるまでの秒数
・マイナス値を指定するとフレームカウント単位で指定となる。
・0を指定するとユーザーが操作するまで待ち続ける。
・省略時は0を指定した事になる。
DIALOG "はじめましょう",5,"シナリオ",-120
ダイアログに表示する文字列
・表示文字列は256文字まで。
・表示文字列内にCHR$(10)かCHR$(13)があると改行する。
| bit0 | Xボタン |
| bit1 | Bボタン |
| bit2 | Yボタン |
| bit3 | Aボタン |
| bit4 | 上ボタン |
| bit5 | 下ボタン |
| bit6 | 左ボタン |
| bit7 | 右ボタン |
| bit8 | L |
| bit9 | R |
| bit10 | ZL |
| bit11 | ZR |
| bit12 | Lスティック押し込み |
| bit13 | Rスティック押し込み |
| bit14 | A,B,X,Yボタンのいずれか |
| bit15 | 上,下,左,右ボタンのいずれか |
| bit16 | スティック押し込み以外のいずれかのボタン |
| bit17 | タッチパネル |
・上記ビット値をORしたものを指定する。
・ゼロを指定するとエラー。
ダイアログ上部のキャプション欄に表示する文字列
・キャプション文字列が46文字より長い場合、46文字までしか表示されない。
・省略時、キャプション欄には"DIALOG"と表示される。
ダイアログを自動的に閉じるまでの秒数
・マイナス値を指定するとフレームカウント単位で指定となる。
・0を指定するとユーザーが操作するまで待ち続ける。
・省略時は0を指定した事になる。
押されたボタンにより、ボタン種類引数相当のビット値が1になった値が返る
・タッチ以外はBUTTON()の返値と同じ物が返る。
・タイムアウトの場合は0が返る。
R=DIALOG("ABXYLR/十字キー/タッチ",(1 << #B_ANY) OR (1 << 17),"特別",0)
入力値としてあらかじめ設定しておくファイル名文字列
・ファイル名に使えない文字を使用するとエラーとなる。
キャプションに表示する文字列
・キャプション文字列が39文字より長い場合、39文字までしか表示されない。
最大32文字まで
取得した文字列
・RESULT関数の返値が-1の場合はキャンセル(文字列無効)。
T$=DIALOG("NEWNAME0","SAVE",14)