view模块
view模块是用于管理执行绘制操作的函数。
模块名
cri.atomcraft.view
定义了以下函数。
| 函数 | 说明 | 操作对象 |
|---|---|---|
| get_file_path_with_dialog | 获取文件路径 | - |
| show_dialog | 显示对话框 | - |
get_file_path_with_dialog
使用对话框获取所选文件的路径。
在输入参数mode中指定要显示的对话框类型。mode(模式)分別为"open"和"save"两种。
- "open": 用于读取文件的对话框
- "save": 用于文件保存的对话框
在输入参数suffix中指定文件扩展名。可以使用以下三种方式指定。
- 仅指定扩展名，例如“csv”和“txt”
- 指定如"Image (*.png, *jpeg) "等种类的名称 + 通配符 + 扩展名
- "指定复杂的规范，例如"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"
在输入参数 folder_path 中指定在对话框中打开的预设文件夹的路径。省略该参数时，将打开Document作为预设文件夹。
从 Ver.3.46.04 开始，添加了本函数。
- 注意
- 本函数无法在控制台执行时使用。
格式
result = get_file_path_with_dialog(mode, suffix, folder_path = "")
输入参数
| 名称 | 值 |
|---|---|
| mode | 对话框的类型 |
| suffix | 对话框选中的文件扩展名 |
| folder_path | 在对话框中打开的预设文件夹 |
返回值
| 名称 | 值 |
|---|---|
| result [ "succeed" ] | 成功时为True，失败时为False |
| result [ "data" ] | 选中文件路径的字符串 |
show_dialog
显示对话框。
对话框中备有能够复制到剪贴板的文本区域以及最多3个按钮。
在输入参数 message 中指定要显示的语句。换行编写为\n。
在输入参数 button_name_list 中，通过列表指定按钮的文本。最多3个按钮。
- (例子1) 要准备“是、否、取消”这3个按钮时，在
button_name_list中指定["是", "否", "取消"]。 - (例子2) 仅需要OK按钮时，在
button_name_list中指定["OK"]。
返回值是关联数组。
关联数组包含 button_index 和 button_name 两个Key。
button_index Key的值是按下的按钮的索引。（索引是从0开始。）
button_name Key的值是按下的按钮的文本。
通过按下x按钮等操作关闭对话框后，索引和名称分别是-1和空字符串。
从 Ver.3.45.00 开始，添加了本函数。
- 注意
- 本函数无法在控制台执行时使用。
格式
result = show_dialog(message, button_name_list)
输入参数
| 名称 | 值 |
|---|---|
| message | 要显示的文本 |
| button_name_list | 按钮名的列表（最多三个） |
返回值
| 名称 | 值 |
|---|---|
| result [ "succeed" ] | 成功时为True，失败时为False |
| result [ "data" ] | 具有 button_index, button_name Key的关联数组 |
| result [ "data" ][ "button_index" ] | 按下的按钮的索引（从0开始） 未按下时为 -1 |
| result [ "data" ][ "button_name" ] | 按下的按钮的文本 |