TreeExpandAll (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Node to expand
Selection bar

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

TreeExpandAll (Function)

In french: ArbreDérouleTout

Expands a node and all its child elements in a TreeView control.

Example of TreeView control:

Reminder: At runtime, a node is expanded when the node name is preceded by "-".

Example

// Expand the "Desserts" node in the "TREE_TVRecipe" TreeView control
// All child elements are also expanded
Res = TreeExpandAll(TREE_TVRecipe, "Recipes" + TAB + "Desserts" )

Syntax

<Result> = TreeExpandAll(<TreeView control> [, <Node to expand>])

<Result>: Boolean

True if the node and its child elements have been expanded,
False otherwise.

<TreeView control>: Control name

Name of the TreeView control to be used.

<Node to expand>: Optional character string

Path of the node to expand (as well as its child elements). This parameter has the following format:

"<Root name>" + TAB + ["<Name of 1st node>" + TAB + ...
["<Name of 2nd node>" + TAB + [...]]]"<Leaf name>"

If this parameter is not specified, the TreeView control is expanded from the root.
If there are two elements with the same name in the path, you can add the IDs of the elements (after their names using TreeID).

Remarks

Node to expand

If the node to expand:

is not found, TreeExpandAll returns False.
is not specified, TreeExpandAll returns True and the TreeView control is expanded from its root.
is a leaf, TreeExpandAll returns True.
is already expanded, TreeExpandAll returns True, and the child elements are expanded if necessary.
is not visible, TreeExpandAll makes this node visible. Its "parent" and "sibling" elements are also displayed. The "parent" elements are expanded.

Versions 20 and later
When TreeExpandAll is called, if the specified branch and/or one of its children have a procedure associated via the AddChildDelayed property, this procedure will be executed.

New in version 20
When TreeExpandAll is called, if the specified branch and/or one of its children have a procedure associated via the AddChildDelayed property, this procedure will be executed.

When TreeExpandAll is called, if the specified branch and/or one of its children have a procedure associated via the AddChildDelayed property, this procedure will be executed.

Selection bar

TreeExpandAll does not change the position of the selection bar.

Component: wd270obj.dll