2.8 `EasyDialogs` -- 基本的なMacintoshダイアログ

利用可能な条件: Macintosh.

EasyDialogsモジュールはMacintoshの単純なダイアログを含んでいます。全てのルーチンは省略可能なリソースIDのパラメータidをとり、対応するダイアログアイテム（タイプとアイテム番号）があれば、このidによってダイアログ用のDLOGリソースを上書きできます。詳細についてはソースを参照してください。

EasyDialogsモジュールには以下の関数が定義されています。

Message( str[, id[, ok=None]]): メッセージテキストstr付きのモーダルダイアログを表示します。テキストの長さは最大255文字です。ボタンのテキストはデフォルトでは``OK''ですが、文字列の引数okが与えられると、その文字列に設定できます。ユーザが``OK''ボタンをクリックすると、ユーザにコントロールが渡されます。

AskString( prompt[, default[, id[, ok[, cancel]]]]): ユーザに文字列値を入力するよう要求するモーダルダイアログ表示します。 promptはプロンプトメッセージで、省略可能なdefault引数は入力文字列の初期値です（指定されないなら""が使われます）。 ``OK''と``Cancel''ボタンの文字列はokとcancelの引数で変えることができます。文字列の長さは全て最大255文字です。 AskString()は入力された文字列を返し、ユーザがキャンセルした場合はNoneを返します。

AskPassword( prompt[, default[, id[, ok[, cancel]]]]): ユーザに文字列を入力するように要求するモーダルダイアログを表示します。 AskString()に似ていますが、テキストは点で表示されます。引数はAskString()のものと同じ意味です。

AskYesNoCancel( question[, default[, yes[, no[, cancel[, id]]]]]): プロンプトquestionと``Yes''、``No''、``Cancel''というラベルの3つボタンが付いたダイアログを表示します。 ``Yes''を押したら1、``No''なら0、``Cancel''なら-1 を返します。 RETURNキーを押した場合はdefaultの値（defaultが設定されていないなら0）を返します。ボタンのテキストはyes、no、cancelの引数で変更できます。ボタンを表示させないためにはその引数に""を与えます。

ProgressBar( [title[, maxval[, label[, id]]]]): プログレスバー付きのモードレスダイアログを表示します。これは後述のProgressBarクラスのためのコンストラクタです。 titleは表示されるテキスト文字列（デフォルトは``Working...''）で、 maxvalは進行が完了するときの値（デフォルトは0で、不定量の作業が残っていることを示します）、labelはプログレスバーの上に表示されるテキストです。

GetArgv( [optionlist[commandlist[, addoldfile[, addnewfile[, addfolder[, id]]]]]])

コマンドライン引数のリストを作るのを補助するダイアログを表示します。引数をgetopt.getopt()に渡すのに適したsys.argvのフォーマットのリストを返します。 addoldfile、addnewfile、addfolderの引数はブーリアン型の引数です。これらが非ゼロなら、存在するファイル、まだ（おそらく）存在しないファイル、フォルダをコマンドラインのパスとしてそれぞれ設定できます。（注意：getopt.getopt()で認識されるために、オブションの引数はコマンドラインの中でファイルとフォルダの引数の前に示されなければなりません。）空白を含む引数は、空白をシングルクォートあるいはダブルクォートで囲んで指定できます。

ユーザが``Cancel''ボタンを押したらSystemExit例外が発生します。

optionlistはポップアップメニューを示すリストで、ユーザはその中から選択できます。ポップアップメニューのアイテムは次の2つの形のうちの1つです。optstr あるいは(optstr, descr)。 descrは短い説明の文字列で、これがあるとポップアップメニューから選択されている間、ダイアログに表示されます。 optstrとコマンドライン引数の対応は以下の通りです。

optstr format Command-line format

x -x （短いオプション）
x:あるいはx= -x （値を持つ短いオプション）
xyz --xyz （長いオプション）
xyz:あるいはxyz= --xyz （値を持つ長いオプション）

`optstr` format	Command-line format
`x`	-x （短いオプション）
`x:`あるいは`x=`	-x （値を持つ短いオプション）
`xyz`	--xyz （長いオプション）
`xyz:`あるいは`xyz=`	--xyz （値を持つ長いオプション）

commandlistはcmdstrあるいは(cmdstr, descr)の形のアイテムからなるリストで、descrは前述のように働きます。cmdstrはポップアップメニューに表示されます。選択されるとcmdstrがコマンドラインに追加されますが、それに続く ":"あるいは"="は（もし存在するなら）取り除かれます。

バージョン2.0 以降で新規追加された仕様です。

AskFileForOpen( [message][, typeList][, defaultLocation][, defaultOptionFlags][, location][, clientName][, windowTitle][, actionButtonLabel][, cancelButtonLabel][, preferenceKey][, popupExtension][, eventProc][, previewProc][, filterProc][, wanted]): 開くファイルをユーザに尋ねるダイアログを表示して、選択されたファイルあるいはユーザがキャンセルしたらNoneを返します。 messageは表示するテキストメッセージで、typeListは選択可能にする4文字のファイルタイプのリスト、defaultLocationは最初に表示すルフォルダのパスネームでFSSpecあるいはFSRefで指定します。 locationはダイアログを表示するスクリーン上の位置の(x, y)で、 actionButtonLabelはOKボタンの位置に``Open''の代わりに表示する文字列、cancelButtonLabelは``Cancel''ボタンの位置に``Cancel''の代わりに表示する文字列、wantedは返したい値のタイプでstring、unicode、AFSSpec、 FSRefとそれらのサブタイプを指定できます。
その他の引数の説明についてはApple Navigation Servicesのドキュメントと EasyDialogsのソースコードを参照してください。

AskFileForSave( [message][, savedFileName][, defaultLocation][, defaultOptionFlags][, location][, clientName][, windowTitle][, actionButtonLabel][, cancelButtonLabel][, preferenceKey][, popupExtension][, fileType][, fileCreator][, eventProc][, wanted]): 保存するファイルをユーザに尋ねるダイアログを表示して、選択されたファイルあるいはユーザがキャンセルしたらNoneを返します。 savedFileNameは保存するファイルのデフォルトの名前（であり、返される値）です。その他の引数の説明についてはAskFileForOpenを参照してください。

AskFolder( [message][, defaultLocation][, defaultOptionFlags][, location][, clientName][, windowTitle][, actionButtonLabel][, cancelButtonLabel][, preferenceKey][, popupExtension][, eventProc][, filterProc][, wanted]): 選択するフォルダをユーザに尋ねるダイアログを表示して、選択されたフォルダあるいはユーザがキャンセルしたらNoneを返します。引数についての説明はAskFileForOpenを参照してください。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。

2.8 EasyDialogs -- 基本的なMacintoshダイアログ

2.8 `EasyDialogs` -- 基本的なMacintoshダイアログ