37.5. EasyDialogs —基本的なMacintoshダイアログ—Pythonドキュメント
37.5。 EasyDialogs —基本的なMacintoshダイアログ
EasyDialogs モジュールには、Macintosh用のいくつかの簡単なダイアログが含まれています。 ダイアログは、ドックに表示される別のアプリケーションで起動され、ダイアログを表示するにはクリックする必要があります。 すべてのルーチンは、オプションのリソースIDパラメータ id を取ります。これを使用すると、ダイアログアイテム（タイプとアイテム番号の両方）がダイアログのアイテムに対応している場合、ダイアログに使用されるDLOGリソースをオーバーライドできます。デフォルトのDLOGリソース。 詳細については、ソースコードを参照してください。
ノート
このモジュールはPython3.xで削除されました。
EasyDialogs モジュールは、次の関数を定義します。
- EasyDialogs.Message(str[, id[, ok]])
- メッセージテキスト str を含むモーダルダイアログを表示します。長さは最大255文字です。 ボタンのテキストはデフォルトで「OK」に設定されていますが、後者が指定されている場合は文字列引数 ok に設定されます。 ユーザーが「OK」ボタンをクリックすると、制御が返されます。
- EasyDialogs.AskString(prompt[, default[, id[, ok[, cancel]]]])
- モーダルダイアログを介して文字列値を入力するようにユーザーに求めます。 prompt はプロンプトメッセージであり、オプションの default は文字列の初期値を提供します（それ以外の場合は
""が使用されます）。 「OK」ボタンと「キャンセル」ボタンのテキストは、 ok および cancel 引数で変更できます。 すべての文字列の長さは最大255バイトです。 AskString（）は、入力された文字列を返します。ユーザーがキャンセルした場合は、 None を返します。
- EasyDialogs.AskPassword(prompt[, default[, id[, ok[, cancel]]]])
- モーダルダイアログを介して文字列値を入力するようにユーザーに求めます。 AskString（）と似ていますが、テキストは箇条書きで示されています。 引数の意味は、 AskString（）の場合と同じです。
- EasyDialogs.AskYesNoCancel(question[, default[, yes[, no[, cancel[, id]]]]])
- プロンプト質問と、「はい」、「いいえ」、「キャンセル」というラベルの付いた3つのボタンを含むダイアログを表示します。 「はい」の場合は
1、「いいえ」の場合は0、「キャンセル」の場合は-1を返します。 RETURN キーを押すと、 default （または default が指定されていない場合は0）の値が返されます。 ボタンのテキストは、 yes 、 no 、および cancel 引数で変更できます。 ボタンが表示されないようにするには、対応する引数に""を指定します。
- EasyDialogs.ProgressBar([title[, maxval[, label[, id]]]])
- モードレスプログレスバーダイアログを表示します。 これは、以下で説明する ProgressBar クラスのコンストラクターです。 title は表示されるテキスト文字列（デフォルトは「Working…」）、 maxval は進行が完了する値（デフォルトは
0）で、作業はまだ完了していません）、 label は、プログレスバー自体の上に表示されるテキストです。
- EasyDialogs.GetArgv([optionlist[ commandlist[, addoldfile[, addnewfile[, addfolder[, id]]]]]])
ユーザーがコマンドライン引数リストを作成するのに役立つダイアログを表示します。 リストを
sys.argv形式で返します。これは、 getopt.getopt（）に引数として渡すのに適しています。 addoldfile 、 addnewfile 、および addfolder はブール引数です。 ゼロ以外の場合、ユーザーはコマンドラインに既存のファイル、（おそらく）まだ存在しないファイル、およびフォルダーへのパスをそれぞれ挿入できます。 （注： getopt.getopt（）で認識されるようにするには、オプション引数をファイルおよびフォルダー引数の前にコマンドラインに表示する必要があります。）スペースを含む引数は、一重引用符または二重引用符で囲むことで指定できます。 ユーザーが「キャンセル」ボタンを押すと、SystemExit例外が発生します。optionlist は、許可されたオプションを選択するためのポップアップメニューを決定するリストです。 そのアイテムは、 optstr または
(optstr, descr)の2つの形式のいずれかを取ることができます。 存在する場合、 descr は、ポップアップメニューでこのオプションが選択されているときにダイアログに表示される短い説明文字列です。 optstr とコマンドライン引数の対応は次のとおりです。optstr 形式
コマンドライン形式
x-x（短いオプション）x:またはx=-x（値付きの短いオプション）xyz--xyz（ロングオプション）xyz:またはxyz=--xyz（値付きのロングオプション）commandlist は、 cmdstr または
(cmdstr, descr)の形式のアイテムのリストです。ここで、 descr は上記のとおりです。 cmdstr がポップアップメニューに表示されます。 選択すると、 cmdstr のテキストがそのままコマンドラインに追加されますが、末尾の':'または'='（存在する場合）は削除されます。バージョン2.0の新機能。
- EasyDialogs.AskFileForOpen([message] [, typeList] [, defaultLocation] [, defaultOptionFlags] [, location] [, clientName] [, windowTitle] [, actionButtonLabel] [, cancelButtonLabel] [, preferenceKey] [, popupExtension] [, eventProc] [, previewProc] [, filterProc] [, wanted] )
ユーザーにファイルを開くように求めるダイアログを投稿し、選択したファイルを返すか、ユーザーがキャンセルした場合はなしを返します。 message は表示するテキストメッセージ、 typeList は許容される4文字のファイルタイプのリスト、 defaultLocation はパス名、
FSSpecまたは[最初に表示するフォルダのX161X] 、 location はダイアログが表示される画面上の(x, y)の位置、 actionButtonLabel は代わりに表示する文字列です[OK]ボタンの[開く]の cancelButtonLabel は、キャンセルボタンの[キャンセル]の代わりに表示する文字列です。必要なは、戻り値として必要な値のタイプです：[X520X ] str 、 unicode 、FSSpec、FSRefおよびそれらのサブタイプが受け入れられます。その他の引数の説明については、Apple NavigationServicesのドキュメントと EasyDialogs のソースコードを参照してください。
- EasyDialogs.AskFileForSave([message] [, savedFileName] [, defaultLocation] [, defaultOptionFlags] [, location] [, clientName] [, windowTitle] [, actionButtonLabel] [, cancelButtonLabel] [, preferenceKey] [, popupExtension] [, fileType] [, fileCreator] [, eventProc] [, wanted] )
- 保存するファイルをユーザーに求めるダイアログを投稿し、選択したファイルを返すか、ユーザーがキャンセルした場合はなしを返します。 savedFileName は、保存先のファイル名（戻り値）のデフォルトです。 他の引数の説明については、 AskFileForOpen（）を参照してください。
- EasyDialogs.AskFolder([message] [, defaultLocation] [, defaultOptionFlags] [, location] [, clientName] [, windowTitle] [, actionButtonLabel] [, cancelButtonLabel] [, preferenceKey] [, popupExtension] [, eventProc] [, filterProc] [, wanted] )
- ユーザーにフォルダーを選択するように求めるダイアログを投稿し、選択したフォルダーを返すか、ユーザーがキャンセルした場合はなしを返します。 引数の説明については、 AskFileForOpen（）を参照してください。
37.5.1。 ProgressBarオブジェクト
ProgressBar オブジェクトは、モードレスプログレスバーダイアログのサポートを提供します。 確定（温度計スタイル）と不確定（バーバーポールスタイル）の両方のプログレスバーがサポートされています。 その最大値がゼロより大きい場合、バーは決定されます。 そうでなければ、それは不確定になります。
バージョン2.2で変更：不確定スタイルのプログレスバーのサポートが追加されました。
ダイアログは作成直後に表示されます。 ダイアログの「キャンセル」ボタンを押すか、 Cmd-。または ESC を入力すると、ダイアログウィンドウが非表示になり、KeyboardInterruptが表示されます（ただし、注意してください）。この応答は、通常はinc()または set（）の呼び出しを介して、プログレスバーが次に更新されるまで発生しません。 それ以外の場合、 ProgressBar オブジェクトが破棄されるまで、バーは表示されたままになります。
ProgressBar オブジェクトには、次の属性とメソッドがあります。
- ProgressBar.curval
- プログレスバーの現在の値（整数型または長整数型）。 通常のアクセス方法は、
0と maxval の間で curval を強制します。 この属性は直接変更しないでください。
- ProgressBar.maxval
- プログレスバーの（整数型または長整数型の）最大値。 curval が maxval と等しい場合、プログレスバー（温度計スタイル）はいっぱいです。 maxval が
0の場合、バーは不確定になります（バーバーポール）。 この属性は直接変更しないでください。
- ProgressBar.title([newstr])
- 進行状況ダイアログのタイトルバーのテキストを newstr に設定します。
- ProgressBar.label([newstr])
- 進行状況ダイアログの進行状況ボックスのテキストを newstr に設定します。
- ProgressBar.set(value[, max])
- プログレスバーの curval を value に設定し、 maxval を max に設定します。 value は、最初に0と maxval の間で強制変換されます。 温度計バーは、不確定から確定への変更、またはその逆の変更を含む変更を反映するように更新されます。
- ProgressBar.inc([n])
- プログレスバーの curval を n だけ、または n が指定されていない場合は
1だけインクリメントします。 （ n が負になる場合があることに注意してください。その場合、効果はデクリメントになります。）プログレスバーは、変更を反映するように更新されます。 バーが不確定な場合、これによりバーバーポールが1回「スピン」します。 結果の curval は、インクリメントによってこの範囲外になる場合、0と maxval の間で強制変換されます。
