名称
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