<TreeView>.Find (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

TreeView functions

Prefix syntax

Find

Presentation

Example

See also

<TreeView>.Find (Function)

In french: <Arbre>.Cherche

Finds an element (leaf or node) in a TreeView control and returns its path.

Example

// Find the element whose identifier is "1" in the "TREE_CustomerTreeView" TreeView control
// Remark: all the elements of the TreeView control are taken into account
ResPath = TREE_CustomerTreeView.Find()

// Find the element whose identifier is "1" in the "TREE_CustomerTreeView" TreeView control
// Search from the root of the TreeView control and only on the leaves
ResPath = TREE_CustomerTreeView.Find(1, Null, tvLeaf)

Syntax

<Result> = <TreeView control>.Find(<Element to find> [, <Path of source element> [, <Options>]])

<Result>: Character string

Path of element found. This string can contain specific control characters. This string can be used in all the functions that manage TreeView controls. This path has the following format:

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

Empty string ("") if no element corresponds to the search.

<TreeView control>: Control name

Name of the TreeView control to be used.

<Element to find>: Character string or integer

Identifier of element to find. This identifier must be identical to the one used in <TreeView>.Add, <TreeView>.Insert or <TreeView>.Modify.

<Path of source element>: Optional character string

Path of source element for the search in the TreeView control. If this parameter is not specified or if it corresponds to the Null constant, the search is performed from the root of TreeView control.

<Options>: Optional constant (or combination of constants)

Specifies the search characteristics:
tvLeaf Search performed on the leaves of TreeView control.
tvNode Search performed on the nodes of TreeView control.
tvOneLevel Search performed on a single level of tree structure (the elements found below the source branch are ignored). The search is performed on the child elements of source element.

By default, the search is performed with tvLeaf + tvNode (all elements found in the TreeView control are browsed).

Component: wd280obj.dll