DirSelectPopup

int DirSelectPopup (char defaultDirectory[], char title[], int allowCancel, int allowMakeDirectory, char pathName[]);

Purpose

Displays a file selection dialog box and waits for the user to select a directory or cancel.

Parameters

Input
Name Type Description
defaultDirectory string Initial directory. If you enter "", the function uses the current working directory.

The maximum length of the default directory is MAX_PATHNAME_LEN bytes, including the NUL byte.
title string Title of the dialog box.
allowCancel integer If nonzero, the user can cancel out of the dialog box.

If zero, the user must make a selection.
allowMakeDirectory integer If nonzero, the user is allowed to create a new directory.
Output
Name Type Description
pathName string Buffer in which the user selection is returned.

The buffer must be at least MAX_PATHNAME_LEN bytes long.

Return Value

Name Type Description
selectionStatus integer The selection status or error codes generated during the function call.

0 VAL_NO_DIRECTORY_SELECTED
1 VAL_DIRECTORY_SELECTED

Negative values indicate that an error occurred.