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 / Table functions
  • Use conditions
  • Branch to collapse
  • Selection bar
  • Runtime speed for the TreeView Table controls
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Collapses:
  • WINDEVWEBDEV - Server codePHP a branch that was previously expanded in a TreeView Table control. "Child" nodes are no longer visible in the TreeView Table control. Child nodes remain in their previous status (collapsed or expanded).
  • a break that was previously expanded in a Table control. The break elements are no longer visible in the Table control.
  • WINDEV a detailed window displayed for a row. For more details, see Managing the details of a row in a Table control.
Reminder At runtime, a node is wrapped when the "+" sign precedes the node name.
Java Breaks are not available for Table controls in this version.
Example
WINDEVWEBDEV - Server codePHP
// Enroule la branche sélectionnée dans le champ Table hiérarchique
TABLEH_Planning.Enroule()
WINDEVWEBDEV - Server codePHP
// Enroule le champ Table hiérarchique "TABLEH_Planning"
TABLEH_Planning.Enroule(1)
// Equivalent à : TABLEH_Planning.EnrouleTout()
WINDEVWEBDEV - Server codePHP
// Enroule la branche spécifiée dans le champ Table hiérarchique
TABLEH_Planning.Enroule("MaRacine" + TAB + "MaBranche")
// Enroule la rupture de la ligne en cours dans le champ Table "TABLE_Rupture"
TABLE_Rupture.Enroule(TABLE_Rupture)
Syntax
WINDEVWEBDEV - Server codePHP

Hierarchical table: wrap a branch by specifying the line number Hide the details

<TreeView Table control>.Collapse([<Row number>])
<TreeView Table control>: Control name
Name of the TreeView Table control to be used.
<Row number>: Optional integer
Number of the row containing the branch to collapse. The branch found in the current row is collapsed if this parameter is not specified.
WINDEVWEBDEV - Server codePHP

Hierarchical table: Wrap a branch by specifying its name Hide the details

<TreeView Table control>.Collapse([<Branch name>])
<TreeView Table control>: Control name
Name of the TreeView Table control to be used.
<Branch name>: Optional character string
Name of branch to collapse. This parameter has the following format:
"<Root name>" + TAB + ["<Name of 1st node>" + TAB + ...
["<Name of 2nd node>" + TAB + [...]]]"<Branch name>"
A WLanguage error occurs if this parameter does not correspond to an existing branch.
The branch found in the current row is collapsed if this parameter is not specified.
If two branches correspond to the specified path, only the first one is collapsed.

Table with breaks: Winding a break Hide the details

<Table control>.Collapse([<Row number> [, <Break name>]])
<Table control>: Control name
Name of the Table control to be used. This control must have one or more breaks. Otherwise, this function has no effect.
<Row number>: Optional integer
Number of the break row to collapse. This number must correspond either to the number of the current row or to the number of the first row of break to collapsed. If this parameter is not specified, the break of current row is collapsed.
<Break name>: Optional character string
Name of break to collapse. This parameter must be specified in case of nested breaks. It allows the break that will be collapsed to be defined. By default, no break is collapsed if the breaks are nested.
WINDEV

Table and hierarchical table: rolling up a detail window Hide the details

<Table control>.Collapse([<Row number>])
<Table control>: Control name
Name of the Table or TreeView Table control to be used.
<Row number>: Optional integer
Number of the row whose details must be collapsed. If this parameter is not specified, the details of the current row are collapsed.
Remarks

Use conditions

TableEnroule_objet can be used on:
  • a Table or TreeView Table with in-memory data source.
  • Table or TreeView Table controls populated programmatically.
  • WEBDEV - Server codePHP a Table control in "Server" or "Server + AJAX" mode.
  • WEBDEV - Browser code a Table control in "Browser" mode.
This function cannot be used on the Table controls based on a data file (direct access).

Branch to collapse

TableEnroule_objet has no effect:
TreeView Table controlTable control with breaks
  • if the branch to collapse is not found.
  • if the branch to collapse is a leaf.
  • if the branch to collapse is already collapsed.
  • if the Table control contains no break.
  • if the Table control contains several breaks and the break to collapse is not specified.
  • if no row is selected in the Table control and if <Row number> is not specified.

Note for hierarchical table fields: If the <Line number> or <Branch name> parameter corresponds to the branch contained in the first line, the entire hierarchy of the hierarchical table field is collapsed (equivalent to the <Table>.CollapseAll function).

Selection bar

For the TreeView Table controls:
  • If the selection bar was positioned on one of the elements of the node to collapse, it is positioned on the collapsed node after the call to TableEnroule_objet.
  • The modification code is called whenever the selection bar is moved. If two levels are collapsed and if the selection bar is positioned on the higher node, the modification codes of each level are run.
For the Table controls with breaks, the selection bar is not modified. It stays on the current element even if the break is collapsed.

Runtime speed for the TreeView Table controls

The runtime speed of syntax 1 is faster than the runtime speed of syntax 2.
Component: wd300obj.dll
Minimum version required
  • Version 23
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 03/28/2025

Send a report | Local help