SelectFolderDialog Interface Reference

A SelectFolderDialog represents the standard select folder dialog box that enables the user to select a folder. More...

Inheritance diagram for SelectFolderDialog:

Collaboration diagram for SelectFolderDialog:

List of all members.

Public Member Functions
	Execute ([out, retval] VARIANT_BOOL *pResult)
	Shows the dialog.
	Close ()
	Closes the dialog.
Properties
ULONG RW	Flags []
	This parameter can be a combination of the following values:.
BSTR RW	Text []
	Gets or sets the text of the dialog.
BSTR RW	Value []
	Gets or sets the selected folder.
BSTR RW	Root []
	Specifies the root folder.
BSTR RW	StatusText []
	Gets or sets the status text.
BSTR RW	Title []
	Gets or sets the title of the dialog.
VARIANT_BOOL RW	EnableOK []
	Enables or disables the OK button/.
VARIANT W	OnChange []
	Sets the event handler for the OnChange event.

---

Detailed Description

A SelectFolderDialog represents the standard select folder dialog box that enables the user to select a folder.

The SelectFolderDialog is the result of CreateSelectFolderDialog method.

See also SelectFolderDialogEvents.

Example (JScript):

o = new ActiveXObject("Scripting.WindowSystemObject")

f = o.CreateForm(0,0,0,0)

f.ClientWidth = 500
f.ClientHeight = 300
f.CenterControl()

f.Show()

dialog = f.CreateSelectFolderDialog()
dialog.Flags = o.Translate("BIF_DEFAULT | BIF_STATUSTEXT | BIF_NEWDIALOGSTYLE | BIF_EDITBOX")
dialog.Text = "SelectFolderDialog Sample"
dialog.StatusText = "Status Text"
dialog.Title = "Select folder"
dialog.Execute()

if (dialog.Value == "")
{
        f.MessageBox("No folder selected");
} else
{
        f.MessageBox("Selected folder: "+dialog.Value)
}

o.Run()

---

Member Function Documentation

Close

(

)

Closes the dialog.

Execute

(

[out, retval] VARIANT_BOOL *

pResult

)

Shows the dialog.

---

Property Documentation

VARIANT_BOOL RW EnableOK

Enables or disables the OK button/.

ULONG RW Flags

This parameter can be a combination of the following values:.

• BIF_RETURNONLYFSDIRS Only file system folders can be selected.
• BIF_DONTGOBELOWDOMAIN Network folders below the domain level not visible.
• BIF_EDITBOX Shows the directory name edit box.
• BIF_NEWDIALOGSTYLE New style dialog (Windows 2000 / XP style)
• BIF_USENEWUI Combination of BIF_NEWDIALOGSTYLE and BIF_EDITBOX
• BIF_BROWSEINCLUDEURLS The dialog can display URLs. BIF_USENEWUI and BIF_BROWSEINCLUDEFILES must be specified.
• BIF_NONEWFOLDERBUTTON Hides the New Folder button.
• BIF_BROWSEFORCOMPUTER Only shows computers.
• BIF_BROWSEFORPRINTER Only shows printers.
• BIF_BROWSEINCLUDEFILES Shows files.

Default: BIF_DEFAULT = BIF_RETURNONLYFSDIRS.

VARIANT W OnChange

Sets the event handler for the OnChange event.

This event occurs when the user changes the selection.

BSTR RW Root

Specifies the root folder.

BSTR RW StatusText

Gets or sets the status text.

BSTR RW Text

Gets or sets the text of the dialog.

BSTR RW Title

Gets or sets the title of the dialog.

BSTR RW Value

Gets or sets the selected folder.

---