TreeSelect (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

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 multi-selection 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 multi-selection 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 multi-selection 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_TVRecipe" TreeView control
ResPath = TreeSelect(TREE_TVRecipe)

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

// Equivalent to:
// i is int
// FOR EACH SELECTED ROW i OF TREE_TREE1
// Trace("Selected element: " + TreeSelect(TREE_TREE1, 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. For more details, see Managing duplicates in the TreeView controls.
This parameter is not supported.
This parameter is ignored.

<Rank>: Optional integer

Versions 16 and later
Rank of the selection for a multi-selection TreeView control. If this parameter is not specified, the index of the 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 multi-selection TreeView control. If this parameter is not specified, the index of the 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 multi-selection TreeView control. If this parameter is not specified, the index of the 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: wd270obj.dll