ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / TreeView Table functions
  • Use conditions
  • Branch to expand
  • Selection bar
  • Runtime speed for the TreeView Table controls
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
Expands:
  • WINDEVWEBDEV - Server codePHP a branch that was previously collapsed in a TreeView Table control. The "child" nodes are visible in the control.
  • a break that was previously collapsed in a Table control. The break elements are visible in the 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 expanded when the node name is preceded by "-".
Java Breaks are not available for Table controls in this version.
iPhone/iPad The syntax used to manage breaks is now available for Table controls in iPhone/iPad applications.
Example
WINDEVWEBDEV - Server codePHP
// Expands the selected branch in the TreeView Table control
TableExpand(TVT_ScheduleTable)
WINDEVWEBDEV - Server codePHP
// Expands the entire TreeView Table control
TableExpand(TVT_ScheduleTable, 1)
// Equivalent to: TableExpandAll(TVT_ScheduleTable)
WINDEVWEBDEV - Server codePHP
// Expands the specified branch in the TreeView Table control
TableExpand(TVT_ScheduleTable, "MyRoot" + TAB + "MyBranch")
Syntax
WINDEVWEBDEV - Server codePHP

TreeView Table control: Expanding a branch while specifying the row number Hide the details

TableExpand(<TreeView Table control> [, <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 expand. The branch found in the current row is expanded if this parameter is not specified.
WINDEVWEBDEV - Server codePHP

TreeView Table control: Expanding a branch, specifying its name Hide the details

TableExpand(<TreeView Table control> [, <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 expand. This parameter has the following format:
"<Root name>" + TAB + ["<Name of 1st node>" + TAB + ...
["<Name of 2nd node>" + TAB + [...]]]"<Leaf name>"
A WLanguage error occurs if this parameter does not correspond to an existing branch.
The branch found in the current row is expanded if this parameter is not specified.

Table control with breaks: Expanding a break Hide the details

TableExpand(<Table control> [, <Row number> [, <Name of break>]])
<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 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.
<Name of break>: 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.
WINDEV

Table and TreeView Table: Expanding a detailed window Hide the details

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

Use conditions

TableExpand can be used on:
  • WINDEVWEBDEV - Server codePHP a TreeView Table control.
  • a Table control populated programmatically.
  • a Table control with in-memory data source.
  • 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 expand

TableExpand 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 TableExpandAll).
  • When TableExpand is called, if the specified branch has a procedure associated via the AddChildDelayed property, this procedure will be executed.

Selection bar

TableExpand 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.
Business / UI classification: UI Code
Component: wd290obj.dll
Minimum version required
  • Version 11
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/21/2022

Send a report | Local help