Note: This page includes content based on the F1 documentation for Centura development. It may be partially converted to support APF development, but should be regarded to be of uncertain actuality. It is provided as is. Eventually, it should be replaced by documentation available from within Visual Studio.
SalBoolean PalDlgOpenFiles(SalWindowHandle hWndOwner,
SalString sDlgTitle,
SalArray<SalString> sFilters,
SalNumber nFilters,
ref SalNumber nIndex,
SalArray<SalString> sFiles,
SalArray<SalString> sPaths)
The PalDlgOpenFiles displays a Windows dialog box where the user can select files to open.
| Name | Description |
|---|---|
| SalWindowHandle HWndOwner | The handle (or name) of the owner of the dialog box. Specify hWndNULL if it has no owner. |
| SalString SDlgTitle | The window title of the Open file dialog box. |
| SalArray<SalString> sFilters | An array of file filters and their descriptions. Each filter must have a description that precedes the filter in the array. |
| SalNumber NFilters | The number of elements in the sFilters array. |
| ref SalNumber NIndex | Filter that will be selected when the dialog opens. When PalDlgOpenFiles returns, this parameter tells what filter the user selected. |
| SalArray<SalString> sFiles | Names of all files selected by the user. No path information is included. |
| SalArray<SalString> sPaths | All files, including complete path and name, selected by the user. |
The return value is TRUE if the user selects a file, FALSE if the user clicks the Cancel button.
This mehtod behaves identically to SalDlgOpenFiles, with the difference that the user is allowed to select multiple files.