DirectoryList Control

[This is preliminary documentation and subject to change.]

This is a special control designed for use on a browse dialog. It is designed to be used with a PathEdit and DirectoryCombo control on the same dialog. It shows the user the folders below the main part of a path (everything except the last segment). It displays the folders below the main part of the currently selected path. If the list contains any folders that don't exist at present time, those are displayed with a different icon. The property associated with this control has to have an initial value, and this value has to contain at least two steps (a volume and at least one level below). The primary goal of this control is to let the user select a subfolder of the current selection. With some additional buttons it also lets the user select a new phantom folder in current selection or step up one step in the path. If the user chooses the create new folder button in a folder where there is a phantom folder already, this folder is selected for editing instead of creating a second phantom folder.

Property

The property associated with this control can be only string valued.

Valid Style Bits

Enabled
Indirect
Sunken
Visible

Valid Control Attributes

Default
Enabled
Indirect
IndirectPropertyName
Position
PropertyName
PropertyValue
Text
Visible
WindowHandle

Control Events Published

DirectoryListNew
IgnoreChange
DirectoryListUp
DirectoryListOpen

Can Take Focus

Windows: Yes.

Related Strings in the UIText Table

NewFolder The default name of a newly created folder.

Remarks

The control is created with the WC_LISTVIEW class with the LVS_LIST, LVS_EDITLABELS, WS_VSCROLL, LVS_SHAREIMAGELISTS, LVS_AUTOARRANGE, LVS_SINGLESEL, WS_BORDER, LVS_SORTASCENDING, WS_CHILD, WS_GROUP, WS_TABSTOP styles.