ダイアログボックスの作成
ダイアログボックスの作成
| modal | ダイアログが閉じるまで,フロントエンドの他の要素へのアクセスを禁止する.これはオプションModalを使って明示的に設定しなければならない |
| blocking | ダイアログが閉じるまでカーネルをブロックする |
モーダルダイアログは,ユーザが何か別のことを行う前にダイアログに応答することを要求する.これにより,フロントエンドはある評価を完了または開始するために必要な情報を得ることができる.例えば,ほとんどのアプリケーションは閉じるときにモーダルダイアログが現れ,ユーザに変更した部分を保存するかどうかを尋ねる.その応答は,どのようにアプリケーションを閉じるかを決めるのに必須なので,ユーザはそれに応答するまでプログラムの他の部分にはアクセスできない.オプションをModal->Trueに設定するとダイアログがモーダルになる.
注意:モーダルダイアログが開いている間は,ユーザはフロントエンドの他のノートブックにアクセスすることができない.このダイアログを閉じるメカニズムがない場合は,Wolframシステムは実質的にフリーズする.
ブロックダイアログは,ユーザがそれに応答するまで実行中の評価を中断するが,フロントエンドの他の部分へのアクセスは禁止しない.これらのダイアログが評価されているカーネルはダイアログが閉じられるまで実質的にブロックされる.例えば,選択ダイアログは評価を開始し,ユーザが値を選ぶまで待機し,それから値を返して評価を終了する.ダイアログが開いている間にメインリンクを通して送られてくる他のすべての評価は待ち行列に入り,ダイアログが閉じられてから評価される.
ダイアログには通常ボタンが含まれており,ユーザはこれを使って質問,メッセージ,その他要求された入力に応答することができる.これらのボタンの一つがデフォルトの動作であり,ダイアログが開いたときにハイライトされている.その他,ほとんど常に含まれているボタンにキャンセルボタンがある.これはダイアログを閉じ,ダイアログの動作を放棄する.
| DefaultButton[] | ダイアログを閉じ,Enterが押されたときのデフォルトであるOKボタン |
| DefaultButton[action] | OKのラベルが付いており,クリックされたときまたはEnterが押されたときに action を評価するボタン |
| DefaultButton[label,action] | label のラベルが付いており,クリックされたときまたはEnterが押されたときに action を評価するボタン |
| CancelButton[] | ダイアログを閉じ,Escが押されたときのデフォルトであるキャンセルボタン |
| CancelButton[action] | キャンセルのラベルが付いており,クリックされたときまたはEscが押されたときに action を評価するボタン |
| CancelButton[label,action] | label のラベルが付いており,クリックされたときまたはEscが押されたときに action を評価するボタン |
| ChoiceButtons[] | OKボタンとキャンセルボタンのペア |
| ChoiceButtons[{actok,actcancel}] | クリックされたときに対応する acti を評価するOKおよびキャンセルボタン |
| ChoiceButtons[{lblok,lblcancel},{actok,actcancel}] | |
ラベル lbli が付いており,クリックされたときに対応する acti を評価する,OKおよびキャンセルボタン | |
DialogInputまたはCreateDialogを使って生成されたダイアログでは,Enterを押すことはOK(デフォルト)ボタンを,Escを押すことはキャンセルボタンをクリックすることに等しい.一つのダイアログ中にいくつかのデフォルトボタンがある場合は,Enterではダイアログの最初のボタンが使われる.同様にEscを押すとダイアログ中の最初のキャンセルボタンが使われる.
ChoiceButtonsを使うと,現行のコンピュータシステムに標準の順序でデフォルトボタンとキャンセルボタンが表示される.
ダイアログノートブックはフロントエンド内の別のウィンドウでノートブックとして,またはセル内の式として開くことができる.ダイアログノートブックはモーダルであることもないこともある非ブロックダイアログである.
| CreateDialog[expr] | expr を含むダイアログノートブックをフロントエンドで作成し,開く |
| DialogNotebook[{cell1,cell2,…}] | フロントエンドで操作することのできるダイアログノートブックのセル内での表現 |
| MessageDialog[expr] | expr を含むメッセージダイアログノートブックをフロントエンドで作成し,開く |
| DialogReturn[expr] | ダイアログウィンドウを閉じ,ダイアログから式 expr を返す |
| Modal | 作成されたダイアログをフロントエンドでモーダルにするかどうかを指定するCreateDialogのオプション |
注意:モーダルダイアログが開いている間,ユーザはフロントエンドの他のノートブックにアクセスすることができない.ダイアログを閉じるメカニズムがない場合,Wolframシステムは事実上フリーズしてしまう.
あるいは,以下のようにしてダイアログノートブックのセル内表現を作成する.{}[[3]]ボタンをクリックするかをDialogNotebook式をCreateDialogでラップすることにより,フロントエンドでノートブックを含む別のウィンドウを開くことができる.
Beepを使ってメッセージダイアログにビープ音も加えると便利なことがある.
ダイアログボックスは入力を受け入れる他,閉じられたときに式を評価することもできる.これはDialogReturnで行える.以下はユーザの入力を受け入れ,変数の割当を評価するモーダルダイアログボックスである.
| DialogReturn[expr] | ダイアログウィンドウを閉じ,ダイアログから式 expr を返す |
| DialogInput[expr] | |
| ChoiceDialog[expr] | フロントエンドで expr を含む選択ダイアログノートブックを作成し,開く |
選択項目を表示するダイアログはChoiceDialogを使って作成することもできる.これはカーネルをブロックして,CancelButtonが選ばれたらFalseを,DefaultButtonが選ばれたらTrueを返す.
ブロックダイアログがボタンかアクションメニューによって投げられた場合,タイムアウトにならないようにボタンアクションをメインリンクに渡す.これはMethod->"Queued"と設定して行うことができる.
Wolfram言語はSystemDialogInputやフロントエンドトークンの他,FileNameSetter,ColorSlider,ColorSetterを含むユーザインターフェース特有のボタン関数を使って,システムダイアログへのアクセスも提供している.
| SystemDialogInput["FileOpen"] | システムファイルを開くダイアログを開き,選択されたファイルパスを返す |
| SystemDialogInput["FileSave"] | システムファイルの保存ダイアログを開き,選択されたファイルパスを返す |
| SystemDialogInput["Color"] | システムの色選択ダイアログを開き,選択されたRGBColor値を返す |
| FrontEndTokenExecute["PrintDialog"] | |
システムの印刷ダイアログを開き,現行のノートブックを印刷する | |
次はシステムの色選択ダイアログを開き,選択した色のRGBColor値を返す.
| FileNameSetter[name,"Open"] | システムのファイルを開くダイアログを開き,値を name に保存するBrowseボタンを生成する |
| FileNameSetter[name,"OpenList"] | システムの複数ファイルを開くダイアログを開き,値を name に保存するBrowseボタンを生成する |
| FileNameSetter[name,"Save"] | システムのファイル保存ダイアログを開き,値を name に保存するBrowseボタンを生成する |
| FileNameSetter[name,"Directory"] | システムのディレクトリ選択ダイアログを開き,値を name に保存するBrowseボタンを生成する |
| ColorSetter[color] | クリックされるとシステムの色選択ダイアログを開く,color に設定された色見本を生成する |
| ColorSlider[color] | ダブルクリックされるとシステムの色選択ダイアログを開く,color に設定された色スライダーを生成する |
Wolfram言語は通常与えられた入力を何でも取り,それを処理することで動作する.しかしより多くの入力を明示的に要求する必要があることもある.これはInputおよびInputStringを使って行われる.
| Input[] | 完全な式を入力として読む |
| Input[prompt] | 入力を要求し,プロンプトとして prompt を表示する |
| Input[prompt,init] | 入力を要求し,プロンプトとして init を入力フィールドの最初のコンテンツとした prompt を表示する |
| InputString[] | 入力として文字列を読む |
| InputString[prompt] | 入力を要求し,プロンプトとして prompt を表示する |
| InputString[prompt,init] | 入力を要求し,プロンプトとして init を入力フィールドの最初のコンテンツとした prompt を表示する |
注意:テキストベースのインターフェースではInputおよびInputStringは改行によって終了する標準的な入力だけを待つ.詳細は「入力の要求」を参照のこと.