ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Controls, pages and windows / TreeView functions
  • Interrupting TreeListItem
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Lists the "children" of a node and the "child" elements of these "children" in a TreeView control. A WLanguage procedure is called whenever a "child" element is found.
Example of TreeView control:
Vocabulary linked to a TreeView control
// Liste les "fils" du noeud "Desserts" dans le champ Arbre "ARBRE_RecetteTV"
// La procédure "DérouleTout" est appelée
// pour chaque "fils" trouvé du noeud "Desserts"
Res = TreeListItem(ARBRE_RecetteTV, "Recettes" + TAB + "Desserts", "DérouleTout")
Syntax
<Result> = TreeListItem(<TreeView control> , <Node path> , <WLanguage procedure> [, <Custom parameter> [, <Duplicate identifier>]])
<Result>: Integer
Number of listed elements.
<TreeView control>: Control name
Name of the TreeView control to be used.
<Node path>: Character string
Full path of node from which the elements will be listed. This parameter:
  • has the following format:
    "<Root name>" + TAB + ["<Name of 1st node>" + TAB + ...
    ["<Name of 2nd node>" + TAB + [...]]]"<Leaf name>"
    If there are two elements with the same name in the path, you can add the IDs of the elements (after their names using TreeID).
  • corresponds to the NULL constant to list from the root of TreeView control.
<WLanguage procedure>: Procedure name
Name of WLanguage procedure that will be called whenever a "child" element is found.
For more details on this procedure, see Parameters of the procedure used by TreeListItem.
<Custom parameter>: Optional integer
Parameter passed to <WLanguage procedure>.
<Duplicate identifier>: Optional boolean
Indicates the management mode of duplicates in the elements:
  • False (default): no management is performed.
  • True: path element names are constructed to contain their identifiers.
Remarks

Interrupting TreeListItem

TreeListItem cannot be interrupted as long as all "child" elements have not been browsed.
To force the interruption of the browse performed by TreeListItem, use the following line of code in <WLanguage procedure>:
RETURN False
In this case, TreeListItem returns the number of elements browsed until the call to "RESULT False".
Component: wd300obj.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 03/27/2025

Send a report | Local help