OpenFileDialog (NotesUIWorkspace - LotusScript®)

Gets file names from the "Open" dialog box.

Note: This method is new with Release 5.

Defined in

NotesUIWorkspace

Syntax

stringArray = notesUIWorkspace .OpenFileDialog( multipleSelection , [title$] , [filters$] , [initialDirectory$] , [initialFile$] )

Parameters

multipleSelection

Boolean.

  • True allows the user to select multiple files.
  • False allows the user to select one file only.

title$

String. Optional. Title for the dialog box. Defaults to "Open."

filters$

String. Optional. User-defined string of filters that can limit the files displayed. For example, "Notes® Databases|*.nsf|Notes Templates|*.ntf" displays only files with the suffixes .nsf and .ntf.

initialDirectory$

String. Optional. The directory to which the dialog box is opened. Otherwise, determined by the system.

initialFile$

String. Optional. Default text for the selection box. Otherwise, no default text for the selection box. This parameter does not apply to platforms such as the Macintosh that do not have a selection box.

Return value

stringArray

An array of type String.

  • (If the user clicks OK) the names of the selected files, one name per array element.
  • (If the user clicks Cancel) the EMPTY value. IsEmpty is True.

Usage

This method returns names. It does not open or perform any other action on files.

See SaveFileDialog for a variation.

Example