int DirSelectPopup (char defaultDirectory[], char title[], int allowCancel, int allowMakeDirectory, char pathName[]);
Displays a file selection dialog box and waits for the user to select a directory or cancel.
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. |
Name | Type | Description | ||||
selectionStatus | integer | The selection status or error codes generated during the function call.
Negative values indicate that an error occurred. |