CRI ADX  Last Updated: 2024-07-17 10:48 p
view模块

view模块是用于管理执行绘制操作的函数。

模块名

cri.atomcraft.view

定义了以下函数。

函数 说明 操作对象
get_file_path_with_dialog 获取文件路径 -
show_dialog 显示对话框 -



get_file_path_with_dialog

使用对话框获取所选文件的路径。
在输入参数mode中指定要显示的对话框类型。mode(模式)分別为"open"和"save"两种。

  • "open": 用于读取文件的对话框
  • "save": 用于文件保存的对话框

在输入参数suffix中指定文件扩展名。可以使用以下三种方式指定。

  1. 仅指定扩展名,例如“csv”和“txt”
  2. 指定如"Image (*.png, *jpeg) "等种类的名称 + 通配符 + 扩展名
  3. "指定复杂的规范,例如"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_indexbutton_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" ] 按下的按钮的文本