ダイアログ - stuncloud/UWSCR GitHub Wiki
MSGBOX
対応バージョン: 0.4.0
メッセージボックスダイアログを表示します
ダイアログのクラス名は UWSCR.MsgBox
押されたボタン = msgbox(メッセージ, ボタン種=BTN_OK, x=EMPTY, y=EMPTY, フォーカスボタン=EMPTY, リンク有効化=FALSE)
| 変数名 | 型 | 種別 | 説明 |
|---|---|---|---|
| メッセージ | 文字列 | 必須 | ダイアログに表示するメッセージ |
| ボタン種 | 定数 | 省略可 | 表示するボタン、省略時はBTN_OKのみ |
BTN_YES (4) はい |
|||
BTN_NO (8) いいえ |
|||
BTN_OK (1) OK |
|||
BTN_CANCEL (2) キャンセル |
|||
BTN_ABORT (16) 中止 |
|||
BTN_RETRY (32) 再試行 |
|||
BTN_IGNORE (64) 無視 |
|||
| x | 数値 | 省略可 | 初期表示位置(x座標)を指定、省略時(EMPTY)は中央表示 |
| -1を指定した場合は前回表示位置 | |||
| y | 数値 | 省略可 | 初期表示位置(y座標)を指定、省略時(EMPTY)は中央表示 |
| -1を指定した場合は前回表示位置 | |||
| フォーカスボタン | 定数 | 省略可 | カーソルの初期位置をボタン定数(BTN_*)で指定 |
| 省略時、または該当するボタンがない場合は一番左のボタン | |||
| リンク有効化 | bool | 省略可 | 未対応 メッセージ内のURLをクリック可能なリンクにするかどうか |
| 押されたボタン | 定数 | 戻り値 | 押されたボタンが定数(BTN_*)で返る |
INPUT
対応バージョン: 0.4.0
インプットボックスダイアログを表示します
ダイアログのクラス名は UWSCR.Input
入力値 = input(メッセージ, デフォルト値=EMPTY, マスク表示=FALSE, x=EMPTY, y=EMPTY)
| 変数名 | 型 | 種別 | 説明 |
|---|---|---|---|
| メッセージ | 文字列 | 必須 | ダイアログに表示するメッセージ |
| 配列 | 1番目の要素がメッセージ | ||
| 2番目以降はラベル名 | |||
| ラベル毎に入力欄が追加される | |||
| ラベルは最大5つ指定可能 | |||
| デフォルト値 | 文字列 | 省略可 | EMPTY以外なら指定した値が予め入力される |
| 配列 | 配列にした場合はラベル毎のデフォルト値になる | ||
| マスク表示 | 真偽値 | 省略可 | 入力値をマスクする (*で表示される) |
| 配列 | 配列にした場合はラベル毎のマスク設定 | ||
| x | 数値 | 省略可 | 初期表示位置(x座標)を指定、省略時(EMPTY)は中央表示 |
| -1を指定した場合は前回表示位置 | |||
| y | 数値 | 省略可 | 初期表示位置(y座標)を指定、省略時(EMPTY)は中央表示 |
| -1を指定した場合は前回表示位置 | |||
| 入力値 | 文字列 | 戻り値 | (入力欄が一つの場合) 入力された値 |
| キャンセル時はEMPTY | |||
| 配列 | (入力欄が複数の場合) 配列でそれぞれの値が返る | ||
| キャンセル時は空の配列 |
複数の入力項目
第一引数(メッセージ)を配列にすることで入力欄を増やせます
1番目の要素がメッセージ表示になり、2番目以降は入力欄の横に表示されるラベル名になります
デフォルト値とマスク表示も配列指定することでそれぞれの入力欄に適用されます
設置できる入力欄は最大で5つです
// ラベルを2つ指定し入力欄を2つにする
labels = ['ログイン', 'ユーザー名', 'パスワード']
// 1つ目の入力欄のみデフォルト値を入れる
default = ['UserA', EMPTY]
// 2つ目の入力欄がマスクされるようにする
mask = [FALSE, TRUE]
// 入力値は配列で返る
user = input(labels, default, mask)
print 'ユーザー名: ' + user[0]
print 'パスワード: ' + user[1]
SLCTBOX
対応バージョン: 0.5.0
セレクトボックスを表示します
ダイアログのクラス名は UWSCR.SlctBox
選択した値 = slctbox(SLCT_定数, タイムアウト秒, メッセージ=EMPTY, 表示項目, [表示項目2, 表示項目3, ..., 表示項目31])
選択した値 = slctbox(SLCT_定数, タイムアウト秒, x, y, メッセージ=EMPTY, 表示項目, [表示項目2, 表示項目3, ..., 表示項目29])
第3、第4引数が数値の場合はx,yが指定されたものとする
ここでは "100" など数値に変換できる文字列を数値として扱わない
引数の上限は固定なのでx,y指定時は項目の指定可能な数が減る
| 変数名 | 型 | 種別 | 説明 |
|---|---|---|---|
| SLCT_定数 | 定数 | 必須 | 項目の表示形式を示す定数 |
SLCT_BTN: ボタン |
|||
SLCT_CHK: チェックボックス |
|||
SLCT_RDO: ラジオボタン |
|||
SLCT_CMB: コンボボックス |
|||
SLCT_LST: リストボックス |
|||
| 戻り値の形式を示す定数 | |||
SLCT_STR: 項目名を返す |
|||
SLCT_NUM: インデックス番号で返す |
|||
| 表示形式を示す定数に戻り値の形式を示す定数を加えることができる | |||
例: SLCT_CHK or SLCT_STR |
|||
| タイムアウト秒 | 数値 | 必須 | 指定秒数経過でダイアログを閉じる (キャンセル扱い) |
| 0ならタイムアウトなし | |||
| x | 数値 | 省略可 | ダイアログを表示する位置のx座標 |
| y | 数値 | 省略可 | ダイアログを表示する位置のY座標 |
| いずれも-1指定で前回の表示位置 | |||
| 座標を指定しない場合は中央表示 | |||
| メッセージ | 文字列 | 省略可 | ダイアログに表示するメッセージ |
| 表示項目 | 文字列 | 必須 | 表示される項目名 |
| 配列 | 必須 | 表示される項目名の配列 | |
| 表示項目2-31 | 文字列または配列 | 省略可 | 表示される項目名 |
| 選択した値 | SLCT_n定数(数値) | 戻り値 | SLCT_STR、SLCT_NUMを指定しなかった場合 |
SLCT_1 から SLCT_31まで |
|||
※ 1番目が選択されたらSLCT_1 |
|||
※ 2番目が選択されたらSLCT_2 |
|||
※ n番目が選択されたらSLCT_n |
|||
SLCT_CHKやSLCT_LSTで複数選択時は加算されて返る |
|||
※ 1番目と3番目が選択されたらSLCT_1 or SLCT_3 |
|||
| 数値 | SLCT_NUM指定時、選択した位置のインデックス番号(0から) |
||
| 配列(数値) | SLCT_CHKまたはSLCT_LST指定時かつSLCT_NUM指定時 |
||
| 文字列 | SLCT_STR指定時、選択した項目名 |
||
| 配列(文字列) | SLCT_CHKまたはSLCT_LST指定時かつSLCT_STR指定時 |
||
| -1 | キャンセル時 (×ボタン、タイムアウト) |
項目数について
SLCT_STR、SLCT_NUMを指定しなかった場合項目数の最大は31- 配列で渡した場合に31を越える可能性があります
- 指定した場合は65535個まで
UWSCとの違い
- タイムアウト秒を指定した場合
- UWSC: 0 を返す
- UWSCR: -1 を返す (×ボタンによるキャンセルと同等)
- 表示項目に連想配列を渡した場合
- 値ではなくキーがメニューに適用されます
- リストやチェックボックスで複数選択時の戻り値 (
SLCT_STRまたはSLCT_NUM指定時)- UWSC: タブ文字で連結された文字列
- UWSCR: 文字列または数値の配列
POPUPMENU
対応バージョン: 0.5.0
ポップアップメニューを表示します
選択した値 = popupmenu(メニュー項目, x=EMPTY, y=EMPTY)
| 変数名 | 型 | 種別 | 説明 |
|---|---|---|---|
| メニュー項目 | 配列(文字列) | 必須 | 配列要素が表示項目になる |
| 要素が配列の場合サブメニューとなる | |||
| x | 数値 | 省略可 | 表示位置のx座標 |
| y | 数値 | 省略可 | 表示位置のy座標 |
| いずれも省略時(EMPTY)の場合マウスカーソル位置 | |||
| 選択した値 | 文字列 | 戻り値 | 選択した項目名 |
| EMPTY | メニューの外側をクリックした場合 |
// サブメニュー表示方法
list = ["項目1", "項目2", "サブメニュー", ["サブ項目1", "サブ項目2"], "項目3"]
// 要素を配列にすると直前の項目のサブメニューになる
selected = popupmenu(list)
// 項目1
// 項目2
// サブメニュー > サブ項目1
// サブ項目2
// 項目3
// ネストも可能
list = ["サブメニュー1", ["サブ1-1", "サブ1-2", "サブメニュー2", ["サブ2-1", "サブ2-2"]]]
popupmenu(list)
UWSCとの違い
- メニュー項目に連想配列を渡した場合
- 値ではなくキーがメニューに適用されます
- メニュー項目を選んだ場合の戻り値
- UWSC: 選択項目のインデックス (数値)
- UWSCR: 選択項目名 (文字列)
- メニュー項目外をクリックした場合
- UWSC: -1
- UWSCR: EMPTY
BALLOON
FUKIDASI
対応バージョン: 0.5.0
吹き出しを表示する
balloon(メッセージ, x=0, y=0, 向き=0, フォントサイズ=既定値, フォント名=既定値, 文字色=$0, 背景色=$FFFF, 透過=0)
fukidasi(メッセージ, x=0, y=0, 向き=0, フォントサイズ=既定値, フォント名=既定値, 文字色=$0, 背景色=$FFFF, 透過=0)
| 変数名 | 型 | 種別 | 説明 |
|---|---|---|---|
| メッセージ | 文字列 | 必須 | 表示されるメッセージ |
| x | 数値 | 省略可 | 表示位置のx座標 |
| y | 数値 | 省略可 | 表示位置のy座標 |
| 向き | 数値 | 省略可 | くちばしの向き (未実装) |
| フォントサイズ | 数値 | 省略可 | 表示サイズ、省略時はフォント設定に従う |
| フォント名 | 文字列 | 省略可 | 表示フォント、省略時はフォント設定に従う |
| 文字色 | 数値 | 省略可 | 文字色をBGRで指定、省略時は黒 |
| 背景色 | 数値 | 省略可 | 背景色をBGRで指定、省略時は黄色 |
| 透過 | 数値 | 省略可 | 未実装 |
- 有効範囲はスレッド単位
- UWSCとは異なり背景に$0指定で黒になります
- BGRの例
- 青:
$FF0000 - 緑:
$00FF00 - 赤:
$0000FF - 白:
$FFFFFF - 黒:
$000000 - 黄:
$00FFFF
- 青:
LOGPRINT
対応バージョン: 0.4.0
printウィンドウの表示状態を変更します
logprint(表示フラグ, [x=EMPTY, y=EMPTY, 幅=EMPTY, 高さ=EMPTY])
| 変数名 | 型 | 種別 | 説明 |
|---|---|---|---|
| 表示フラグ | 真偽値 | 必須 | print文実行時にprintウィンドウを表示するかどうか |
| TRUE指定時は即座にprintウィンドウを表示します | |||
| x | 数値 | 省略可 | printウィンドウ表示位置のx座標、EMPTYで現状を維持 |
| y | 数値 | 省略可 | printウィンドウ表示位置のy座標、EMPTYで現状を維持 |
| 幅 | 数値 | 省略可 | printウィンドウの幅、EMPTYで現状を維持 |
| 高さ | 数値 | 省略可 | printウィンドウの高さ、EMPTYで現状を維持 |