TableItemStatus (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

A collapsed or expanded node can be visible or not
Selection bar
Runtime speed

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

TableItemStatus (Function)

In french: TableEtatElément

Returns the status of a node in a Treeview Table control: collapsed, expanded or not found.

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

Versions 18 and later

This function is now available for the PHP sites.

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

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

New in version 18

This function is now available for the PHP sites.

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

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

This function is now available for the PHP sites.

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

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

Example

// Status of a node
SWITCH TableItemStatus(TVT_Schedule, ...
"Root" + TAB + "Node" + TAB + "Leaf2")
CASE taError: Trace("The node does not exist.")
CASE taExpand: Trace("The node is expanded.")
CASE taCollapse: Trace("The node is collapsed.")
END

Syntax

Status of a node by specifying the row number Hide the details

<Result> = TableItemStatus(<TreeView Table control> [, <Row Number>])

<Result>: Integer constant

Status of specified node:
taExpand The node is expanded
taCollapse The node is collapsed
taError Node not found

<TreeView Table control>: Control name

Name of TreeView Table control to use.

<Row Number>: Optional integer

Number of the row containing the node to use. If this parameter is not specified, the status of the node found in the current row is returned.

Status of a node by specifying its name Hide the details

<Result> = TableItemStatus(<TreeView Table control> [, <Node Name>])

<Result>: Integer constant

Status of specified node:
taExpand The node is expanded
taCollapse The node is collapsed
taError Node not found

<TreeView Table control>: Control name

Name of TreeView Table control to use.

<Node Name>: Optional character string (with quotes)

Name of node to use. 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.
If this parameter is not specified, the status of the node found in the current row is returned.

Remarks

A collapsed or expanded node can be visible or not

The status returned corresponds to the internal status of the element. An expanded element is not necessarily visible because one of its parents may be collapsed.

For example: If the node "Recipes" + TAB + "Desserts" is collapsed, the node" Recipes" + TAB + "Desserts" + TAB + "Ice creams" can be collapsed or expanded.

Selection bar

TableItemStatus does not modify the position of the selection bar.

Runtime speed

The runtime speed of syntax 1 is faster than the runtime speed of syntax 2.

Component : wd240obj.dll