EasyDialogs

该EasyDialogs模块包含一些简单的Macintosh对话框。对话框将在单独的应用程序中启动，该应用程序出现在扩展坞中，并且必须单击该对话框以显示对话框。所有例程都有一个可选的资源ID参数标识DLOG，只要对话项对应（默认DLOG资源中的类型和项目编号），就可以覆盖用于该对话框的资源。详情请参阅源代码。

注意

此模块已在Python 3.x中删除。

该EasyDialogs模块定义了以下功能：

EasyDialogs.Message(str[, id[, ok]])

显示消息文本str的模态对话框，该消息文本的长度最多为255个字符。按钮文本默认为“OK”，但如果提供后者，则设置为字符串参数ok。用户单击“确定”按钮时会返回控件。

EasyDialogs.AskString(prompt[, default[, id[, ok[, cancel]]]])

要求用户通过模态对话框输入字符串值。prompt是提示消息，并且可选的default提供字符串的初始值（否则""使用）。“OK”和“Cancel”按钮的文本可以通过ok和cancel参数进行更改。所有的字符串最长可以有255个字节。AskString()返回输入的字符串或None万一用户取消。

EasyDialogs.AskPassword(prompt[, default[, id[, ok[, cancel]]]])

要求用户通过模态对话框输入字符串值。例如AskString()，但文字显示为项目符号。参数的含义与AskString()相同。

EasyDialogs.AskYesNoCancel(question[, default[, yes[, no[, cancel[, id]]]]])

提示带有提示问题的对话框和三个标有“是”，“否”和“取消”的按钮。 返回1表示“是”，0表示“否”，-1表示“取消”。 当按下RETURN键时，返回默认值（或者如果默认值没有提供，则返回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)。当存在时，descr是一个简短的描述性字符串，当在弹出菜单中选择该选项时，该字符串将显示在对话框中。_optstr_s和命令行参数之间的对应关系是：

commandlist的形式为项目的列表cmdstr或(cmdstr, descr)，其中DESCR如上。该cmdstr_s会出现一个弹出菜单。选择后，_cmdstr的文本将作为原样追加到命令行，除了尾部':'或'='（如果存在）将被删除。

2.0版本中的新功能。

EasyDialogs.AskFileForOpen( [message] [, typeList] [, defaultLocation] [, defaultOptionFlags] [, location] [, clientName] [, windowTitle] [, actionButtonLabel] [, cancelButtonLabel] [, preferenceKey] [, popupExtension] [, eventProc] [, previewProc] [, filterProc] [, wanted] )

发布一个对话框，要求用户打开一个文件，并返回所选文件或None用户取消。消息是要显示的文本消息，typeList是允许的4字符文件类型的列表，defaultLocation是路径名FSSpec或FSRef最初显示的文件夹的位置，位置是(x, y)显示对话框的屏幕上的位置，actionButtonLabel是字符串显示的不是“开放”的确定按钮，cancelButtonLabel是在取消按钮来显示，而不是“取消”，一个字符串想是价值的类型要当一回：str，unicode，FSSpec，FSRef 其亚型是可以接受的。

有关其他参数的说明，请参阅Apple导航服务文档和EasyDialogs源代码。

EasyDialogs.AskFileForSave( [message] [, savedFileName] [, defaultLocation] [, defaultOptionFlags] [, location] [, clientName] [, windowTitle] [, actionButtonLabel] [, cancelButtonLabel] [, preferenceKey] [, popupExtension] [, fileType] [, fileCreator] [, eventProc] [, wanted] )

发布一个对话框，询问用户要保存的文件，并返回所选文件或None用户取消。savedFileName是要保存到的文件名的默认值（返回值）。请参阅AskFileForOpen()其他参数的说明。

EasyDialogs.AskFolder( [message] [, defaultLocation] [, defaultOptionFlags] [, location] [, clientName] [, windowTitle] [, actionButtonLabel] [, cancelButtonLabel] [, preferenceKey] [, popupExtension] [, eventProc] [, filterProc] [, wanted] )

发布一个对话框，要求用户选择一个文件夹，然后返回所选文件夹或None用户取消。请参阅AskFileForOpen()参数说明。

扩展内容

导航服务参考程序员关于导航服务的参考文档，是Carbon框架的一部分。

1. ProgressBar对象

ProgressBar对象为非模态进度条对话框提供支持。支持确定（温度计样式）和不确定（理发杆样式）进度条。如果条的最大值大于零，条将会确定; 否则它将是不确定的。

在版本2.2中更改：添加了对不确定样式进度条的支持。

该对话框在创建后立即显示。如果按下了对话框的“取消”按钮，或者如果Cmd-.或ESC键入了对话框，对话框窗口将被隐藏并KeyboardInterrupt引发（但请注意，直到下一次更新进度条时才会发生此响应，通常是通过调用inc()或set()）。否则，栏会保持可见状态，直到ProgressBar丢弃该对象。

ProgressBar 对象拥有以下属性和方法：

ProgressBar.curval

进度条的当前值（整型或长整型）。正常访问方法curval之间强制0和maxval。这个属性不应该直接修改。

ProgressBar.maxval

进度条的最大值（整型或长整型）; 进度条（温度计样式）在curval等于时已满maxval。如果maxval是0，bar将是不确定的（barber-pole）。这个属性不应该直接修改。

ProgressBar.title([newstr])

将进度对话框的标题栏中的文本设置为newstr。

ProgressBar.label([newstr])

将进度对话框的进度框中的文本设置为newstr。

ProgressBar.set(value[, max])

将进度条设置curval为值，如果提供后者，也maxval将其设置为最大值。值首先在0和0之间被强制maxval。温度计栏会更新以反映变化，包括从不确定变为确定或反之亦然。

ProgressBar.inc([n])

进度条的曲线增加n，如果不提供n，则增加1。 （请注意，n可能是负数，在这种情况下，效果是递减）。进度条会更新以反映更改。 如果bar是不确定的，这导致barber pole的一个“旋转”。 如果递增导致它落在此范围之外，则所得到的曲线在0和maxval之间被强制。