dev_open_file_dialogdev_open_file_dialogDevOpenFileDialogDevOpenFileDialogdev_open_file_dialog开发打开文件对话框（算子）

名称

dev_open_file_dialogdev_open_file_dialogDevOpenFileDialogDevOpenFileDialogdev_open_file_dialog — 打开文件选择对话框。

签名

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

描述

dev_open_file_dialogdev_open_file_dialogDevOpenFileDialogDevOpenFileDialogDevOpenFileDialogdev_open_file_dialog 用于打开文件选择对话框，用于读取单个文件（ModeModeModeModemodemode = 'read'"read""read""read""read""read"）、读取一个或多个文件（ModeModeModeModemodemode = 'read_multi'"read_multi""read_multi""read_multi""read_multi""read_multi"）、写入文件（ModeModeModeModemodemode = 'write'"write""write""write""write""write"）或选择目录（ModeModeModeModemodemode = 'dir'"dir""dir""dir""dir""dir"）。如果 ModeModeModeModemodemode 设置为 'default'"default""default""default""default""default"，且 FilterFilterFilterFilterfilterfilter 设置为一个 HALCON 算子，则类型将设置为该算子所使用的值。

FilterFilterFilterFilterfilterfilter 用于指定待读取或写入的文件类型。FilterFilterFilterFilterfilterfilter 可设置为一个 HALCON 算子（例如 read_imageread_imageReadImageReadImageReadImageread_image），该算子将负责读取或写入所选文件。在这种情况下，过滤器将根据 HALCON 算子所使用的文件类型进行相应设置。要选择 JPEG 和 TIFF 格式的图像，可以将过滤器设置为 'Images (*.jpg *.tif *.tiff)'"Images (*.jpg *.tif *.tiff)""Images (*.jpg *.tif *.tiff)""Images (*.jpg *.tif *.tiff)""Images (*.jpg *.tif *.tiff)""Images (*.jpg *.tif *.tiff)" 或 'JPEG Files (*.jpg);;TIFF-Files (*.tif *.tiff)'。在第一种情况下，选择 ‘Images’ 条目将同时显示所有受支持的图像文件。在第二种情况下，可选择 JPEG 文件或 TIFF 文件。过滤器不区分大小写，因此 'JPEG Files (*.jpg)'"JPEG Files (*.jpg)""JPEG Files (*.jpg)""JPEG Files (*.jpg)""JPEG Files (*.jpg)""JPEG Files (*.jpg)" 和 'JPEG Files (*.JPG)'"JPEG Files (*.JPG)""JPEG Files (*.JPG)""JPEG Files (*.JPG)""JPEG Files (*.JPG)""JPEG Files (*.JPG)" 将返回相同的结果。系统会自动添加 'All Files (*)'"All Files (*)""All Files (*)""All Files (*)""All Files (*)""All Files (*)"。若要组合多个过滤器，需用 ';;'";;"";;"";;"";;"";;" 分割。

示例：

过滤器 'Images (*.jpg *.tiff *.tif)'"Images (*.jpg *.tiff *.tif)""Images (*.jpg *.tiff *.tif)""Images (*.jpg *.tiff *.tif)""Images (*.jpg *.tiff *.tif)""Images (*.jpg *.tiff *.tif)" 会列出所有扩展名为 jpg、tiff 和 tif 的文件。

过滤器 'JPEG Files (*.jpg)'"JPEG Files (*.jpg)""JPEG Files (*.jpg)""JPEG Files (*.jpg)""JPEG Files (*.jpg)""JPEG Files (*.jpg)" 会列出所有扩展名为 jpg 的文件。

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

PathPathPathPathpathpath 可用于设置工作目录。若将 PathPathPathPathpathpath 设为 'default'"default""default""default""default""default"，则工作目录将设为该 ModeModeModeModemodemode 类型上次使用的目录。

执行成功后，SelectionSelectionSelectionSelectionselectionselection 中将包含所选文件或文件。

注意

此算子不支持代码导出。

参数

FilterFilterFilterFilterfilterfilter (输入控制) string → (string)

要选择的文件类型。

ModeModeModeModemodemode (输入控制) string → (string)

文件选择对话框的模式。

默认值： 'default' "default" "default" "default" "default" "default"

值列表： 'default'"default""default""default""default""default", 'dir'"dir""dir""dir""dir""dir", 'read'"read""read""read""read""read", 'read_multi'"read_multi""read_multi""read_multi""read_multi""read_multi", 'write'"write""write""write""write""write"

PathPathPathPathpathpath (输入控制) string → (string)

工作目录。

默认值： 'default' "default" "default" "default" "default" "default"

SelectionSelectionSelectionSelectionselectionselection (输出控制) string(-array) → (string)

已选文件名。

默认值： 'default' "default" "default" "default" "default" "default"

示例（HDevelop）

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

结果

如果指定参数的值正确，dev_open_file_dialogdev_open_file_dialogDevOpenFileDialogDevOpenFileDialogDevOpenFileDialogdev_open_file_dialog 返回 2 (H_MSG_TRUE)。否则，将抛出一个异常并返回错误代码。

替代

dev_open_dialogdev_open_dialogDevOpenDialogDevOpenDialogDevOpenDialogdev_open_dialog

另见

dev_open_dialogdev_open_dialogDevOpenDialogDevOpenDialogDevOpenDialogdev_open_dialog

模块

基础

算子