Documentation

ChooseDir

METHOD

CHOOSEDIR

Description

CHOOSEDIR launches a dialog that permits the user to navigate to a chosen subdirectory and then return that directory name in param1.

OBJECT

A field mark delimited dynamic array representing the options for the dialog having a layout as follows :-

<ZZ16CD_STARTING_FOLDER$>

Holds the name of the starting folder.

<ZZ16CD_ONLY_COMPUTERS$>

TRUE$ to show only computers

<ZZ16CD_ONLY_PRINTERS$>

TRUE$ to show only printers

<ZZ16CD_ONLY_DOMAINS$>

TRUE$ to show only domains

<ZZ16CD_ONLY_ANCESTORS$>

TRUE$ to show only ancestors

An ancestor is a subfolder that is beneath the root folder in the namespace hierarchy. If the user selects an ancestor of the root folder that is not part of the file system, the OK button is grayed.

<ZZ16CD_ONLY_FILE_SYSTEM$>

TRUE$ to show only the file system

<ZZ16CD_SHOW_PATH$>

TRUE$ to show the path in the dialog (default)

<ZZ16CD_NEW_FOLDER$>

TRUE$ to show the new folder button

<ZZ16CD_ROOT_FOLDER$>

Integer flag to specify the root folder. Possible integer values are as follows :-

ZZ16CD_ROOT_DESKTOP$	Starts with just the desktop visible
ZZ16CD_ROOT_DESKTOP_EXPANDED$	Starts with an expanded desktop
ZZ16CD_ROOT_PROGRAMS$	Starts with the program folder as root
ZZ16CD_ROOT_CONTROL_PANEL$	Starts with the control panel as root
ZZ16CD_ROOT_PRINTERS$	Starts with the printer folder as root
ZZ16CD_ROOT_PERSONAL$	Starts with the personal "My Documents" folder as root
ZZ16CD_ROOT_FAVOURITIES$	Starts with the "My Favourites" folder as root
ZZ16CD_ROOT_STARTUP$	Starts with the Startup folder as root
ZZ16CD_ROOT_RECENT$	Starts with the recent folder as root
ZZ16CD_ROOT_SENDTO$	Starts with the Send To folder as root
ZZ16CD_ROOT_RECYCLEBIN$	Starts with the recycle bin as root
ZZ16CD_ROOT_STARTMENU$	Starts with the start menu as root
ZZ16CD_ROOT_DESKTOPFOLDER$	Starts with the desktop folder as root
ZZ16CD_ROOT_MYCOMPUTER$	Starts with My Computer as root
ZZ16CD_ROOT_NETWORK$	Starts with "Network Places" as root
ZZ16CD_ROOT_NETWORKNEIGHBORHOOD$	Starts with network neighbourhood as root
ZZ16CD_ROOT_FONTS$ to 17	Starts with the font folder as root
ZZ16CD_ROOT_TEMPLATES$ to 18	Starts with the templates folder as root

Only the specified folder and any subfolders that are beneath it in the namespace hierarchy will appear in the dialog box. This member can be NULL$; in that case, the namespace root (the desktop folder) is used.

PARAM1

Returns name of the folder chosen

PARAM2

n/a

PARAM3

n/a

PARAM4

n/a

PARAM5

n/a

ERRORTEXT

Any error message

Code Sample showing starting at a specific subdirectory

Method<ZZ16CD_STARTING_FOLDER$> = "c:\Documents and Settings"
Directory = ''
RetVal = zz_Utility_Dll("CHOOSEDIR", Method, Directory)

Screen dump

Code Sample showing computer

Method = ""
Method<ZZ16CD_ONLY_COMPUTERS$> = 1
Directory = ''
RetVal = zz_Utility_Dll("CHOOSEDIR", Method, Directory)

Screen dump

Code sample showing New Folder button enabled without the folder title

Method = ""
Method<ZZ16CD_STARTING_FOLDER$> = "c:\Revsoft"
Method<ZZ16CD_SHOW_PATH$> = 0
Method<ZZ16CD_NEW_FOLDER$> = 1
Directory = ''
RetVal = zz_Utility_Dll("CHOOSEDIR", Method, Directory)

[top]