TreePosition (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Displaying an element at the beginning of list (syntax 2)
Selecting the element of row whose subscript is

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

TreePosition (Function)

In french: ArbrePosition

Displays a TreeView control from a specified element (node or leaf) or returns the name of the first element displayed in a TreeView control.

Example of TreeView control:

Example

// Name of first element displayed in the "TREE_RecipeTV" treeview
ResElementName = TreePosition(TREE_RecipeTV)

Syntax

Finding out the name of the first element displayed in a TreeView control Hide the details

<Result> = TreePosition(<TreeView Control> [, <Duplicate Identifier>])

<Result>: Character string

Full path of first element displayed in the TreeView control.
This result 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).

<TreeView Control>: Control name

Name of TreeView control to use.

<Duplicate Identifier>: Optional boolean

Specifies the management mode of duplicates in the elements of <Result>:
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.

Displaying a TreeView control from a specified element Hide the details

<Result> = TreePosition(<TreeView Control> , <Node Path>)

<Result>: Character string

Full path of the first element displayed in the TreeView control after the call to TreePosition.
This result has 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.

<Node Path>: Character string

Full path of the node that will be displayed in first position in the TreeView control.
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

Displaying an element at the beginning of list (syntax 2)

The element displayed first may differ from the one requested. Indeed, if there are not enough elements displayed below the <Node Path> element, this element cannot be displayed at the beginning of TreeView control

For example, the "Cold starters" node cannot be displayed at the beginning of TreeView control: there are not enough elements displayed below this node.

Selecting the element of row whose subscript is <Subscript>

To select the element found at <Subscript> row, use:

the direct assignment:

<TreeView Control> = Subscript

If the row is displayed in the TreeView control, the corresponding element is selected.
TreeSelectPlus:

TreeSelectPlus(<TreeView Control>, <Full Element Path>)

Component : wd240obj.dll