ユーザーから文字列値を取得するためのダイアログを作成します。
説明
popup-text-query TextField および [OK] と [キャンセル] ボタンのあるダイアログを作成します。
- [OK] ボタンを使用してダイアログを閉じると、popup-text-query は
TextField のコンテンツを返します。 - [キャンセル] ボタンを使用して (または閉じるボックスをクリックして) ダイアログを閉じると、NULL を返します。
label: TextField の前にダイアログに表示されるラベルです。
prefix: TextField の初期値。
title: ダイアログのタイトル バーに表示される String 。既定は "テキスト入力ウィンドウ" です。
max-chars: TextField に入力できる最大文字数。
owner: このダイアログが中心に位置する View 。null は、ダイアログが画面上部の 3 分の 2 の部分に中央揃えで表示されます。
このダイアログのオーナー。オーナーが指定されていない場合、GuiManager は、可能である場合、既定のオーナーを選択します。
このダイアログのオーナー。オーナーが指定されていない場合、
max-width: ポップアップ ダイアログの最大幅。
large-icon: 大きなアイコン (32x32 ピクセル) が必要な場合に使用されるイメージ。これが null の場合、ダイアログのアイコンは設定されません。
small-icon:
small-icon は、large-icon が非 null の場合のみに使用されます。
...: TextField に追加されるオプションの EventHandler です。
戻り値
[OK] ボタンがクリックされたときの文字列です。それ以外は NULL になります。
例
テキストで使用される値を取得する popup-text-query の使い方を次に示します。
| 例 | |
 | |
{value
let cap:Dynamic = {Dynamic "Initial caption"}
{VBox
spacing=3pt,
{paragraph The caption is: {value cap}},
{CommandButton
label="change title",
{on Action do
let new-title =
{popup-text-query
"enter new caption",
prefix=cap.value,
title="Sample text query"
}
{unless new-title == null do
set cap.value = new-title
}
}
}
}
}
|
注意事項
特権の無いポップアップダイアログに関しては、large-icon および small-icon は効力がありません。
注意事項
small-icon を使用しないウインドウシステムもあります。 View の表題にアイコンを表示しないものもあります。 これは基本的にウインドウシステムによって違います。
注意事項
もし owner が null の場合、ポップアップダイアログの View は最上位の View となります。