ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / TreeView Table functions
  • Managing a sorted TreeView Table control
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Sorts a branch in a TreeView Table control on one or more columns.
Example
// Sort the "Designation" and "Price" columns in the "TVT_Product" control
// The "Designation" column is sorted in ascending order
// The "Price" column is sorted in descending order
TableSortChild(TVT_Product, Null, "Designation", "-Price")
// Sort the branch in descending order
TableSortChild(TVT_Product, "Plumbing" + TAB + "Faucets", "Designation", "-Price")
Syntax

Sorting a branch in a TreeView Table control on one or more columns identified by their name. Hide the details

<Result> = TableSortChild(<TreeView Table control> , <Branch to sort> , <Name of column 1> [, <Name of column 2> [... [, <Name of column N>]]])
<Result>: Boolean
  • True if the sort was performed,
  • False otherwise.
<TreeView Table control>: Control name
Name of the TreeView Table control to be used.
If this parameter corresponds to an empty string (""), the control to which the current event belongs will be used.
<Branch to sort>: Integer or character string
If this parameter is an integer, it corresponds to the index of the parent containing the branch to be sorted.
If this parameter corresponds to NULL, the sort is performed on the "Root" elements.
If this parameter corresponds to a character string, it corresponds to the parent element containing the branch to sort.
<Name of column 1>: Character string
Name of first column to sort (up to 16 columns). This parameter has the following format:
"[<Direction>]<Column name>" where:
  • <Direction> (character) indicates the sort direction:
    • "+": ascending sort (by default),
    • "-": descending sort.
  • <Column name> (character string): name of column to sort.
<Name of column 2>: Optional character string
Name of the second column to sort (up to 16 columns). This parameter has the following format:
"[<Direction>]<Column name>" where:
  • <Direction> (character) indicates the sort direction:
    • "+": ascending sort (by default),
    • "-": descending sort.
  • <Column name> (character string): name of column to sort.
<Name of column N>: Optional character string
Name of the Nth column to sort (up to 16 columns). This parameter has the following format:
"[<Direction>]<Column name>" where:
  • <Direction> (character) indicates the sort direction:
    • "+": ascending sort (by default),
    • "-": descending sort.
  • <Column name> (character string): name of column to sort.

Sorting a branch in a TreeView Table control according to a list of column names Hide the details

<Result> = TableSortChild(<List of columns> , <Branch to sort>)
<Result>: Boolean
  • True if the sort was performed,
  • False otherwise.
<List of columns>: Character string
List of columns to sort (up to 16 columns). This parameter has the following format:
"[<Direction>]<Name of column1> + TAB + [<Direction>]<Name of column2> + TAB + ..." where:
  • <Direction> (character) indicates the sort direction:
    • "+": ascending sort (by default),
    • "-": descending sort.
  • <Column name> (character string): name of column to sort. The column name is returned by TableEnumColumn.
<Branch to sort>: Integer or character string
If this parameter is an integer, it corresponds to the index of the parent containing the branch to be sorted.
If this parameter corresponds to NULL, the sort is performed on the "Root" elements.
If this parameter corresponds to a character string, it corresponds to the parent element containing the branch to sort.

Sorting a branch in a TreeView Table control on the first ten visible columns Hide the details

<Result> = TableSortChild(<TreeView Table control> , <Branch to sort> [, <To sort>])
<Result>: Boolean
  • True if the sort was performed,
  • False otherwise.
<TreeView Table control>: Control name
Name of TreeView Table control to sort. This parameter has the following format:
"[<Direction>]<TreeView Table control>" where:
  • <Direction> (character) indicates the sort direction:
    • "+": ascending sort (by default),
    • "-": descending sort.
  • <TreeView Table control> (character string): name of TreeView Table control to sort.
<Branch to sort>: Integer or character string
If this parameter is an integer, it corresponds to the index of the parent containing the branch to be sorted.
If this parameter corresponds to NULL, the sort is performed on the "Root" elements.
If this parameter corresponds to a character string, it corresponds to the parent element containing the branch to sort.
<To sort>: Optional boolean
Remarks

Managing a sorted TreeView Table control

Business / UI classification: UI Code
Component: wd290obj.dll
Minimum version required
  • Version 12
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 10/02/2023

Send a report | Local help