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 expand
  • 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
Expands:
  • a break that was previously collapsed in a Table control. The break elements are visible in the control.
Reminder At runtime, a node is unrolled when the "-" sign precedes the node name.
Example
Syntax

Table control with breaks: Unroll a break Hide the details

<Table control>.Expands([<Row number> [, <Break name>]])
<Table control>: Control name
Name of the Table control to be used.
<Row number>: Optional integer
Number of the row whose break will be expanded. This number must correspond either to the number of the current row, or to the number of the first row of the break to expand. If this parameter is not specified, the break of current row is collapsed.
<Break name>: Optional character string
Name of the break to be expanded. This parameter must be specified in case of nested breaks. It is used to define the break that will be expanded. By default, no break is expanded if the breaks are nested.
Remarks

Use conditions

<Table>.Expand can be used on:
  • a Table control populated programmatically.
  • a Table control with in-memory data source.
This function cannot be used on the Table controls based on a data file (direct access).

Branch to expand

<Table>.Expand 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 if the break to expand is not specified.
  • if no row is selected in the Table control and if <Row number> is not specified.

Remarks for the TreeView Table controls:
  • If <Row number> or <Branch name> corresponds to the branch in the first row, the entire hierarchy of the TreeView Table control is expanded (equivalent to <Table>.ExpandAll).
  • When <Table>.Expand is called, if the specified branch has a procedure associated via the AddChildDelayed property, this procedure will be executed.

Selection bar

<Table>.Expand does not change the position of the selection bar.

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