PalDlgBrowseForFolder

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 PalDlgBrowseForFolder( SalWindowHandle hWndOwner,
		               SalString sMessage,
		               ref SalString sFolderName,
		               ref SalString sFolderPath )

The PalDlgBrowseForFolder displays a Windows dialog box where the user can browse for a folder using a listbox structure.

Parameters

Name Description
SalWindowHandle hWndOwner The handle (or name) of the owner of the dialog box. Specify hWndNULL if it has no owner
SalString sMessage Message text shown to the user in the dialog box. This parameter should be a translatable constant.
ref SalString sFolderName The name of the selected folder.
ref SalString sFolderPath The entire path to the selected folder including the folder name. If a valid path is specified (including the folder name) upon startup, the dialog will automatically browse and set focus on that folder.

Returns

The return value is TRUE if the user selects a folder, FALSE if the user clicks the Cancel button.