Skip to end of metadata
Go to start of metadata

This service displays a file selection dialog with the specified title (if any) in which the user can browse the file system to select a file. The fileExtensions port specifies a comma separated list of the file extensions that the user can use to filter their view of the files. The fileExtLabels contains a comma separated list with the same number of elements. Each entry in fileExtLabels specifies the text by which the corresponding file extension will be displayed to the user. For example, if fileExtensions is 'bin,txt' then a sensible value for fileExtLabels is 'binary files, text files'. If no filtering of the files is to be made available then fileExtensions and fileExtLabels should be set to the empty string. The user always has the option to view all files. When the user clicks Open, the service outputs the path to the selected file to the selectedFile port. If the user clicks Cancel then an exception is generated.

Input ports

  • title - The title used for the dialog. This is an optional parameter.
  • fileExtensions - A comma separated list of the file extensions by which the shown files can be filtered. If no filtering is allowed then an empty string should be specified. This is a mandatory parameter.
  • fileExtLabels - A comma separated list of the text used to describe the file extensions. The number of entries must be the same as for fileExtensions. If no filtering is allowed then an empty string should be specified. This is a mandatory parameter.

Output ports

  • selectedFile - The path of the file that the user selected.
Labels
  • None