ListBox.AddFolder

From Real Software Documentation

Appends Item in a new row to the end of the list and adds disclosure triangle only if the Hierarchical property is set to True.

For multi-column ListBoxes, Item is always assigned to column zero. In the case of hierarchical ListBoxes, AddFolder appends Item to the subitems of the expanded row when called in the ExpandRow event.

Examples

The following example adds creates a hierarchical ListBox. Note that AddFolder must be called to create the hierarchical relationship.

See the section “Hierarchical Listboxes” in the Notes section for illustrations of the ListBox in expanded and collapsed states.

Volume Browser Example

The “Volume Browser” example project in the Examples folder that ships with Real Studio is a file browser that displays the file structure of the user's hard disks as a hierarchical listbox. Is uses a custom class based on the ListBox. The Open event of the custom class builds the hierarchical list using AddFolder in a For loop for all of the user’s mounted volumes. The code for the Open event is this:

The ExpandRow event uses AddRow to display nested folders and files in the directory. Again, AddFolder is nested in a large For loop.