Returns a full path to a selected directory by opening the Windows Choose Directory dialog box.

Syntax:

DirDlg(description, root, show new folder)

Parameters:

description – description string

root – initial parking directory

show new folder – Logical. Setting this value to Yes will show the New Folder button.

Returns:

An Alpha string that contains the full path of the selected directory.

Example:

DirDlg('My Description','d:\temp','TRUE'LOG) opens the 'Open Directory' dialog box and returns the selected directory.

Note:

If the selected path does not exist, this function opens the current work directory.

Pressing the ESC or Cancel button returns an empty string.

Platform specific:

This function is not supported for mobile devices.

Exceptions:

This function is not supported for Rich Client and Web Client tasks. Use the ClientDirDlg function to open the Dir dialog box on the client side.

See also:

FileDlg

The Online Samples project (program EL18)