CNSImage_File_SelectFolderWithDialog

Description

You can use this function to choose a folder using a dialog box. You can use the optional "StartPath" parameter to specify which folder to display when the dialog first opens. You can use the optional "Prompt" parameter to display a message in the dialog box.

Return Type

Text

Format

CNSImage_File_SelectFolderWithDialog ( StartPath ; Prompt )

Optional Parameters

• StartPath
  

  The Path to the Folder to display when the dialog first opens.

• Prompt
  

  An optional Prompt or Message to display on the Dialog.

Related Items

CNSImage_Export, CNSImage_File_Copy, CNSImage_File_Delete, CNSImage_File_Exists, CNSImage_File_GetPath, CNSImage_File_SelectFileWithDialog, CNSImage_Import, Reference: Paths

Examples

Example 1

Code:

CNSImage_File_SelectFolderWithDialog

Result:

Displays a dialog so you can choose folder. The chosen path is returned.

Example 2

Code:

CNSImage_File_SelectFolderWithDialog("/")

Result:

Displays a dialog so you can choose a folder, starting with the startup volume or first drive.

Example 3

Code:

CNSImage_File_SelectFolderWithDialog("";"Please choose a folder:")

Result:

Displays a dialog so you can choose folder with the prompt: "Please choose a folder". The chosen path is returned.