Halcon算子翻译——dev_open_file_dialog

名称

dev_open_file_dialog - 打开文件选择对话框。

用法

dev_open_file_dialog( : : Filter, Mode, Path : Selection)

描述

　　dev_open_file_dialog打开一个文件选择对话框，可以用于读取一个文件（Mode ='read'），读取一个或多个文件（Mode ='read_multi'），写入（Mode ='write'）文件或选择（Mode ='dir'） 一个目录。 如果Mode被设置为'default'并且Filter被设置为HALCON算子，则类型被设置为算子将使用的值。

　　Filter可以用来选择应该选择读取或写入的文件的类型。 Filter可以设置为HALCON算子，例如read_image等可以读取或写入选定的文件的算子。 在这种情况下，filter被设置为适合HALCON算子使用的文件。 要选择JPEG和TIFF类型的图像，可以将filter设置为'Images (*.jpg *.tif *.tiff)' 或'JPEG Files (*.jpg);;TIFF-Files (*.tif *.tiff)'。 在第一种情况下，通过选择条目“Images”，所有支持的图像文件会一起显示。 在第二种情况下，可以在JPEG文件或TIFF文件之间进行选择。 Filter不区分大小写，因此‘JPEG Files (*.jpg)' 和'JPEG Files (*.JPG)'提供相同的效果。 'All Files (*)' 始终添加。 要组合多个过滤器，必须用“;;”分隔它们。

例子：

　　Filter'Images（* .jpg * .tiff * .tif）'列出了扩展名为jpg，tiff和tif的所有文件。

　　Filter“JPEG文件（* .jpg）”列出所有扩展名为jpg的文件

　　3个filter的组合：Images (*.jpg *.tiff *.tif);;JPEG Files (*.jpg);;TIFF Files (*.tiff *.tif)'

　　Path可以用来设置工作目录。 如果Path设置为'default'，则工作目录被设置为上次使用Mode类型时所在的目录。

　　成功执行后，Selection将包含选定的单个文件或多个文件。

注意

此算子不支持导出

参数

Filter (input_control) 　　　　    string → (string)
　　要选择的单个文件或多个文件的类型。

Mode (input_control) 　　 　　  string → (string)
　　文件选择对话框的Mode。
　　Default value: 'default'
　　List of values: 'default', 'dir', 'read', 'read_multi', 'write'

Path (input_control) 　　 　　   string → (string)
　　工作目录
　　Default value: 'default'

Selection (output_control) 　　 string(-array) → (string)
　　选定的文件名。
　　Default value: 'default'

示例（HDevelop）

dev_open_file_dialog ('read_image', 'default','c:/',Selection)
read_image(ToolId, Selection)

结果

如果指定参数的值正确，则dev_open_file_dialog返回2（H_MSG_TRUE）。 否则会引发异常并返回错误代码。

备选算子

dev_open_dialog

See also

dev_open_dialog

模块

Foundation

HDevelop例程

dev_open_file_selection_dialog.hdev 　　 Open modal dialogs to read or write files or a directory in HDevelop