TableSortChild (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Controls, pages and windows / TreeView Table functions

Managing a sorted TreeView Table control

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

TableSortChild (Function)

In french: TableTrieFils

Sorts a branch in a TreeView Table control on one or more columns.

Example

// Tri des colonnes "Désignation" et "Prix" dans le champ "TABLEH_Produit"
// La colonne "Désignation" est triée dans l'ordre croissant
// La colonne "Prix" est triée dans l'ordre décroissant
TableSortChild(TABLEH_Produit, Null, "Désignation", "-Prix")

// Tri de la branche selon le prix décroissant
TableSortChild(TABLEH_Produit, "Plomberie" + TAB + "Robinets", "Désignation", "-Prix")

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 sorting (default),
"-": sorting in descending order.
<Nom de la colonne> (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 sorting (default),
"-": sorting in descending order.
<Nom de la colonne> (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 sorting (default),
"-": sorting in descending order.
<Nom de la colonne> (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 sorting (default),
"-": sorting in descending order.
<Nom de la colonne> (string): name of the column to be sorted. 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 sorting (default),
"-": sorting in descending order.
<Champ Table hiérarchique> (string): name of TreeView Table control to be sorted.

<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

True if the sort must be performed,
False if the previous sort must be canceled. Once the sort is canceled, the order of the table rows is not modified but the rows that will be added by TableAdd, TableAddLine, TableAddChild, TableInsert, TableInsertLine or TableInsertChild will not be sorted.

Remarks

Managing a sorted TreeView Table control

When a TreeView Table control is sorted by TableSortChild, the additions performed by TableAdd, TableAddLine, TableAddChild, TableInsert, TableInsertLine or TableInsertChild take the sort into account.
When a TreeView Table control is sorted by clicking, the additions made by TableAdd, TableAddLine, TableAddChild, TableInsert, TableInsertLine or TableInsertChild ignore the sort.
The sort is not canceled by TableDisplay, TableAdjust, TableSearch, TableCount, TablePosition, TableSelect, TableSelectMinus, TableSelectPlus, TableDelete and TableDeleteAll.
The sort is canceled:
- if a column is modified (by direct input in the column or by TableModify and TableModifyLine) and if this column is sorted.
- by TableSort (TableSort(<Table control>, False)).

Business / UI classification: UI Code

Component: wd300obj.dll