<TreeView Table>.SortChild (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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

Managing a sorted TreeView Table control

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<TreeView Table>.SortChild (Function)

In french: <Table hiérarchique>.TrieFils

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
TABLEH_Produit.TrieFils(Null, "Désignation", "-Prix")

// Tri de la branche selon le prix décroissant
TABLEH_Produit.TrieFils("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> = <TreeView Table control>.SortChild(<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.

<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.

Remarks

Managing a sorted TreeView Table control

When a TreeView Table control is sorted by <TreeView Table>.SortChild, the additions performed by <Table>.Add, <Table>.AddLine, <TreeView Table>.AddChild, <Table>.Insert, <Table>.InsertLine or <TreeView Table>.InsertChild take the sort into account.
When a TreeView Table control is sorted by clicking, the additions made by <Table>.Add, <Table>.AddLine, <TreeView Table>.AddChild, <Table>.Insert, <Table>.InsertLine or <TreeView Table>.InsertChild ignore the sort.
The sort is not canceled by <Table>.Display, <Table>.Adjust, TableSearch, <Table>.Count, <Table>.Position, <Table>.Select, <Table>.SelectMinus, <Table>.SelectPlus, <Table>.Delete and <Table>.DeleteAll.
The sort is canceled:
- if a column is modified (by direct input in the column or by <Table>.Modify and <Table>.ModifyLine) and if this column is sorted.
- by <Table>.Sort (<Table control>.Sort(False)).

Component: wd300obj.dll