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

Use conditions
Branch to expand
Selection bar
Runtime speed for the TreeView Table controls

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

TableExpand (Function)

In french: TableDéroule

Expands:

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.
Versions 22 and later
a detailed window displayed for a row. For more details, see Managing the details of a row in a Table control.
New in version 22
a detailed window displayed for a row. For more details, see Managing the details of a row in a Table control.
a detailed window displayed for a row. For more details, see Managing the details of a row in a Table control.

Reminder: At run time, a node is expanded when the node name is preceded by "-".

The breaks are not available on the Table controls in this version.

Versions 18 and later

This function is now available for the TreeView Table controls in the PHP sites.

This function is now available for the TreeView Table controls in the WEBDEV sites in Windows.

This function is now available for the TreeView Table controls in the WEBDEV sites in Linux.

New in version 18

This function is now available for the TreeView Table controls in the PHP sites.

This function is now available for the TreeView Table controls in the WEBDEV sites in Windows.

This function is now available for the TreeView Table controls in the WEBDEV sites in Linux.

This function is now available for the TreeView Table controls in the PHP sites.

This function is now available for the TreeView Table controls in the WEBDEV sites in Windows.

This function is now available for the TreeView Table controls in the WEBDEV sites in Linux.

Versions 20 and later

This function is now available for the Table controls in Browser code.

This function is now available for the Table controls in the PHP sites.

This function is now available for the Table controls in the WEBDEV sites in Windows.

This function is now available for the Table controls in the WEBDEV sites in Linux.

New in version 20

This function is now available for the Table controls in Browser code.

This function is now available for the Table controls in the PHP sites.

This function is now available for the Table controls in the WEBDEV sites in Windows.

This function is now available for the Table controls in the WEBDEV sites in Linux.

This function is now available for the Table controls in Browser code.

This function is now available for the Table controls in the PHP sites.

This function is now available for the Table controls in the WEBDEV sites in Windows.

This function is now available for the Table controls in the WEBDEV sites in Linux.

Versions 22 and later

This function is now available for table fields in Android applications.

This feature is now available for Table fields in iPhone/iPad applications.

New in version 22

This function is now available for table fields in Android applications.

This feature is now available for Table fields in iPhone/iPad applications.

This function is now available for table fields in Android applications.

This feature is now available for Table fields in iPhone/iPad applications.

Versions 25 and later

The syntax used to manage breaks is now available for Table controls in iPhone/iPad applications.

New in version 25

The syntax used to manage breaks is now available for Table controls in iPhone/iPad applications.

Example

// Expands the selected branch in the TreeView Table control
TableExpand(TVT_ScheduleTable)

// Expands the entire TreeView Table control
TableExpand(TVT_ScheduleTable, 1)
// Equivalent to: TableExpandAll(TVT_ScheduleTable)

// Expands the specified branch in the TreeView Table control
TableExpand(TVT_ScheduleTable, "MyRoot" + TAB + "MyBranch")

Syntax

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 TreeView Table control to use.

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

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 TreeView Table control to use.

<Branch name>: Optional character string (with quotes)

Name of branch to expand. This parameter has the following format:

"<Name of root>" + 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 Table control to use. 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 break to expand. 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.

Versions 22 and later

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.

New in version 22

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.

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

The function TableExpand can be used on:

a TreeView Table control.
a memory Table control.
a browsing Table control loaded in memory.
an Ajax Table control or a classic Table control.
a Table control in browser mode.

This function cannot be used on the browsing Table controls (direct access).

Branch to expand

TableExpand has no effect:


TreeView Table control	Table 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 contained in the first row, the entire hierarchy of the TreeView Table control is expanded (equivalent to TableExpandAll).
Versions 19 and later
During the call to TableExpand, if the specified branch includes a procedure associated by ..AddChildDelayed, this procedure will be run.
New in version 19
During the call to TableExpand, if the specified branch includes a procedure associated by ..AddChildDelayed, this procedure will be run.
During the call to TableExpand, if the specified branch includes a procedure associated by ..AddChildDelayed, this procedure will be run.

Selection bar

TableExpand does not modify 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: wd260obj.dll