【机器视觉】 dev_open_file

00. 目录

文章目录

00. 目录
01. 概述
02. 签名
03. 描述
04. 注意
05. 参数
06. 结果
07. 附录

01. 概述

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

02. 签名

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

03. 描述

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将包含选定的单个文件或多个文件。

原文描述：

dev_open_file_dialog opens a file selection dialog for reading one file (Mode = ‘read’), reading one or more files (Mode = ‘read_multi’), writing (Mode = ‘write’) a file or choosing (Mode = ‘dir’) a directory. If Mode is set to ‘default’ and Filter is set to an HALCON operator the type is set to the value the operator would use.

The Filter can be used to select the types of the files which shall be selected for reading or writing. The Filter can be set to an HALCON operator, for example read_image, which should read or write the selected file. In that case, the filter is set appropriate to the files used by the HALCON operator. To select images of type JPEG and TIFF the filter could be set to ‘Images (.jpg .tif .tiff)’ or 'JPEG Files (.jpg);;TIFF-Files (.tif .tiff)’. In the first case, by selecting the entry ‘Images’ all supported images files are displayed together. In the second case it is possible to choose between JPEG Files or TIFF Files. The Filter is not case sensitive, therefore the same results are supplied by 'JPEG Files (.jpg)’ and 'JPEG Files (.JPG)’. The ‘All Files (*)’ is always added. To combine more than one filter you have to separate them by ‘;;’.

Examples:

The filter ‘Images (*.jpg *.tiff *.tif)’ lists all files with the extensions jpg,tiff und tif.

The filter ‘JPEG Files (*.jpg)’ lists all files with the extension jpg

Combination of 3 filters: ‘Images (*.jpg .tiff .tif);;JPEG Files (.jpg);;TIFF Files (.tiff *.tif)’

The Path can be used to set the working directory. If Path is set to ‘default’ the working directory is set to the last one used for this type of Mode.

After a successful execution the Selection contains the selected files or file.

04. 注意

此算子不支持代码导出

05. 参数

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_selection_dialog.hdev Open modal dialogs to read or write files or a directory in HDevelop

程序示例

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

06. 结果

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

07. 附录

7.1 机器视觉博客汇总
网址：https://dengjin.blog.csdn.net/article/details/116837497