TreeSelect (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

TreeSelect (Function)

In french: ArbreSelect

Returns the full path of selected element in a TreeView control.

Example of TreeView control:

Versions 16 and later

Remark: TreeSelect can be used on:

a browsing or memory TreeView control, or a TreeView control on source.
a single-selection or multiselection TreeView control.. For multiselection TreeView controls, TreeSelect must be used in a loop in order to get all selected rows.

New in version 16

Remark: TreeSelect can be used on:

a browsing or memory TreeView control, or a TreeView control on source.
a single-selection or multiselection TreeView control.. For multiselection TreeView controls, TreeSelect must be used in a loop in order to get all selected rows.

Remark: TreeSelect can be used on:

a browsing or memory TreeView control, or a TreeView control on source.
a single-selection or multiselection TreeView control.. For multiselection TreeView controls, TreeSelect must be used in a loop in order to get all selected rows.

Example

// Full path of selected element in the "TREE_RecipeTV" TreeView control
ResPath = TreeSelect(TREE_RecipeTV)

// Selected rows in a multiselection memory TreeView control
FOR i = 1 _TO_ TreeSelectOccurrence(TREE_TREEVIEW1)
Trace("Selected element: " + TreeSelect(TREE_TREEVIEW1, False, i))
END

// Equivalent to:
// i is int
// FOR EACH SELECTED ROW i OF TREE_TREEVIEW1
// Trace("Selected element: " + TreeSelect(TREE_TREEVIEW1, False, i-1))
// END

Syntax

<Result> = TreeSelect(<TreeView control> [, <Management of duplicates> [, <Rank>]])

<Result>: Character string

Full path of selected element, in the following format:

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

<TreeView control>: Control name

Name of TreeView control to use.

<Management of duplicates>: Optional boolean

Mode for managing duplicates in the elements:
False (default value): no management is performed.
True: the names of path elements are built in order to contain their identifier. See Managing duplicates in the TreeView controls for more details.
This parameter is ignored.

<Rank>: Optional integer

Versions 16 and later
Rank of the selection for a multiselection TreeView control. If this parameter is not specified, the subscript of first selected row is returned.
For example, to retrieve the first selected element, <Rank> = 1.
To retrieve the second selected element, <Rank> = 2, etc.
This parameter is not supported.
New in version 16
Rank of the selection for a multiselection TreeView control. If this parameter is not specified, the subscript of first selected row is returned.
For example, to retrieve the first selected element, <Rank> = 1.
To retrieve the second selected element, <Rank> = 2, etc.
This parameter is not supported.
Rank of the selection for a multiselection TreeView control. If this parameter is not specified, the subscript of first selected row is returned.
For example, to retrieve the first selected element, <Rank> = 1.
To retrieve the second selected element, <Rank> = 2, etc.
This parameter is not supported.

Related Examples:

Unit examples (WINDEV): The TreeView control

[ + ] Using the TreeView control via the WLanguage Tree functions.

Component : wd240obj.dll