<TreeView>.Expand (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Node to expand
Selection bar

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<TreeView>.Expand (Function)

In french: <Arbre>.Déroule

Expands a node in a TreeView control. The "child" elements (nodes or leaves) of this node become visible.

Example of TreeView control:

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

Example

// Expand the "Desserts" node in the "TREE_RecipeTV" TreeView control
Res = TREE_RecipeTV.Expand("Recipes" + TAB + "Desserts")

Syntax

<Result> = <TreeView control>.Expand(<Node to expand>)

<Result>: Boolean

True if the node was expanded,
False otherwise.

<TreeView control>: Control name

Name of TreeView control to use.

<Node to expand>: Character string

Path of node to expand. This parameter has the following format:

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

In case of duplicates on a path element, this path can contain the element identifier (specified at the end of its name by TreeID).

Remarks

Node to expand

If the node to expand:

is not found, <TreeView>.Expand returns False.
is a leaf, <TreeView>.Expand returns True.
is already expanded, <TreeView>.Expand returns True.
is not visible, <TreeView>.Expand makes this node visible. Its "parent" and "sibling" elements are also displayed. The "parent" elements are expanded.

Versions 19 and later
During the call to <TreeView>.Expand, if the specified branch includes a procedure associated by ..AddChildDelayed, this procedure will be run.

New in version 19
During the call to <TreeView>.Expand, if the specified branch includes a procedure associated by ..AddChildDelayed, this procedure will be run.

During the call to <TreeView>.Expand, if the specified branch includes a procedure associated by ..AddChildDelayed, this procedure will be run.

Selection bar

<TreeView>.Expand does not modify the position of the selection bar.

Component : wd240obj.dll