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 not supported.
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.

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.

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.

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