Home Contact Site Map Privacy Policy Rev Search
Choose Dir
 

News & Info
Products
Services
Developer's Corner
Sample Projects
Site Search
Sprezzatura Links
Support Section

Up
Choose Dir
Choose File
Choose Font
System Info


 

 

 ChooseDir

METHODCHOOSEDIR
DescriptionCHOOSEDIR launches a dialog that permits the user to navigate to a chosen subdirectory and then return that directory name in param1.
  
OBJECTA 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 17Starts with the font folder as root
ZZ16CD_ROOT_TEMPLATES$ to 18Starts 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.

PARAM1Returns name of the folder chosen
PARAM2n/a
PARAM3n/a
PARAM4n/a
PARAM5n/a
ERRORTEXTAny error message
  
Code Sample showing starting at a specific subdirectoryMethod<ZZ16CD_STARTING_FOLDER$> = "c:\Documents and Settings"
Directory = ''
RetVal = zz_Utility_Dll("CHOOSEDIR", Method, Directory)
Screen dump
Code Sample showing computerMethod = ""
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 titleMethod = ""
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]

 
Copyright © 2005 The Sprezzatura Group. All rights reserved.