TreeMapSeek (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

TreeMapSeek (Function)

In french: TreeMapCherche

Finds the subscript of an element in a TreeMap control from the element path. This path was specified in TreeMapAdd.

Example

// The TMAP_Wine control is filled from a Table control.
// Find the element corresponding to the selected element in the Table control
SelectionPath is string
SelectionPath = COL_WineType[TABLE_WINE] + "\" + COL_Owner[TABLE_WINE]
ElementSubscript = TreeMapSeek(TMAP_Wine, SelectionPath)
// Select the element in the TreeMap control
IF ElementSubscript <> - 1 THEN
TMAP_Wine = ElementSubscript
END

Syntax

<Result> = TreeMapSeek(<TreeMap control> , <Element path> [, <Start subscript>])

<Result>: Integer

Subscript of element found,
-1 if no element corresponds to the search.
Remark: The element found can be directly handled via its subscript. You can for example modify the properties of this element or select it in the TreeMap control.

<TreeMap control>: Control name

Name of TreeMap control used.
If this parameter corresponds to an empty string (""), the control used will be the TreeMap control to which the current event belongs.

<Element path>: Character string (with quotes)

Path and caption of sought element. This path must be identical to the one used when the element was added into the TreeMap control by TreeMapAdd.
The separator of different path elements can be:
the "\" character. For example: "MyDirectory\MyFile".
the "TAB" character. For example: "Desserts"+TAB+"Ice cream".

<Start subscript>: Optional integer

Subscript of the element from which the search will be performed. If this parameter is not specified, the search is performed in the entire TreeMap control. This parameter is used to find all the occurrences of a path.

Component: wd260obj.dll