TreeID (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Handling the duplicate elements in a TreeView control
When to use TreeID?

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

TreeID (Function)

In french: ArbreID

Allows you to build the path of the elements found in a TreeView control by differentiating the duplicates. This function can be used in all the functions for handling the elements found in a TreeView control.

Example

ResultTreeView is boolean
ResultTreeView = TreeAdd(TREE_TreeView1, "Root" + TAB + "Leaf", ...
tvDefault, tvDefault, "Id unique leaf")
ResultTreeView = TreeAdd(TREE_TreeView1, "Root" + TAB + "Leaf", ...
tvDefault, tvDefault, "Id unique leaf 2", tvAcceptDuplicate)
// Delete the 2nd duplicate
TreeDelete(TREE_TreeView1, "Root" + TAB + "Leaf" + ...
TreeID("Unique leaf 2 ID"))

Syntax

<Result> = TreeID(<Identifier>)

<Result>: Character string

Control string that must be added to the name of the element when it is handled by the TreeView control management functions.

<Identifier>: Character string (with quotes)

Element identifier. This identifier is used to build the control string of the element. This identifier must be identical to the one used in TreeAdd, TreeInsert or TreeModify.

Remarks

Handling the duplicate elements in a TreeView control

The management of duplicates in TreeView controls is based on the management of identifiers. Each section of the path of a TreeView control element can be associated with an identifier. This association is performed by TreeAdd, TreeInsert or TreeModify.

TreeID is used to handle the duplicate elements via their identifier. To do so, add the control string corresponding to the element of the requested path.

Example:

TreeDelete(TREE_TreeView1, "Root" + TAB + "Leaf" + ...
TreeID("Unique leaf 2 ID"))

In this example, two "Leaf" elements are found. TreeID was used to identify the one that must be deleted.

When to use TreeID?

TreeID can be used:

in all the syntaxes of the TreeView control management functions, as soon as the path of a duplicate element must be specified.
in the <TreeView control name>[<Element path>] syntax, which is used to easily manipulate an element of a TreeView control.

The element used is the one whose path and identifier match.

Remark: An identifier can be specified for each section of the path of an element.

Related Examples:

Unit examples (WINDEV): The TreeView control

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

Component: wd260obj.dll