Handling a TreeView Table control by programming (prefixed syntax)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Overview
Initializing a TreeView Table control
Adding or modifying rows in a TreeView Table control
Adding rows into a TreeView Table control
Modifying a row or a column
Resuming input in a column
Adding or deleting a column
Managing calculated columns
Operations on the rows and cells
Deleting a row
Selecting a row
Retrieving the row content or the cell content
Value of a cell in the current row
Value of a cell in a specific row
Content of current row
Content of specific row
Operations on the tree structure
Collapsing all nodes of a TreeView Table control
Expanding all nodes of a TreeView Table control
Finding out the number of collapsed/expanded row
Defining the next status during an addition
Finding out and modifying the images of rows
Check Box TreeView column
Finding out the parent or the children of an element
Properties specific to the TreeView Table controls

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Handling a TreeView Table control by programming (prefixed syntax)

Overview

The main concepts for programming TreeView Table controls are as follows. Several WLanguage functions allow you to manage the TreeView Table controls by programming.

Do not hesitate to see the documentation about these functions. For more details, see list of functions for managing the TreeView Table controls.

Versions 18 and later

The TreeView Table control is now available for WEBDEV sites.

The TreeView Table control is now available for PHP sites.

New in version 18

The TreeView Table control is now available for WEBDEV sites.

The TreeView Table control is now available for PHP sites.

The TreeView Table control is now available for WEBDEV sites.

The TreeView Table control is now available for PHP sites.

Initializing a TreeView Table control

To fill a TreeView Table control by programming, you have the ability to use the following functions:

<Table>.AddLine, <TreeView Table>.AddChild, <Table>.InsertLine and <TreeView Table>.InsertChild: in each row, the value of each column is separated by commas.
<Table>.Add and <Table>.Insert: in each row, the value of each column is separated by TAB.

If a new row was added into a TreeView Table control by <Table>.Add, <Table>.Insert, <Table>.AddLine, <TreeView Table>.AddChild, <Table>.InsertLine or <TreeView Table>.InsertChild, the NewLine property is set to True (otherwise, it is set to False).

Versions 19 and later

Remark: To properly fill a TreeView Table control, you can use the AddChildDelayed property on the rows of the control.
In this case, the principle for filling the control is simplified:

When initializing the control, only the first-level elements are loaded. Each element is associated with the AddChildDelayed property.
When the user clicks the element on the first level to expand it, the procedure defined by the AddChildDelayed property is executed. This procedure fills the level to expand. The search for children is performed only when the user wants to see them.

New in version 19

Remark: To properly fill a TreeView Table control, you can use the AddChildDelayed property on the rows of the control.
In this case, the principle for filling the control is simplified:

When initializing the control, only the first-level elements are loaded. Each element is associated with the AddChildDelayed property.
When the user clicks the element on the first level to expand it, the procedure defined by the AddChildDelayed property is executed. This procedure fills the level to expand. The search for children is performed only when the user wants to see them.

Remark: To properly fill a TreeView Table control, you can use the AddChildDelayed property on the rows of the control.
In this case, the principle for filling the control is simplified:

When initializing the control, only the first-level elements are loaded. Each element is associated with the AddChildDelayed property.
When the user clicks the element on the first level to expand it, the procedure defined by the AddChildDelayed property is executed. This procedure fills the level to expand. The search for children is performed only when the user wants to see them.

Adding or modifying rows in a TreeView Table control

Adding rows into a TreeView Table control

The creation of a row in a TreeView Table control is not automatically performed. It must be explicitly requested via a call to:

<Table>.Add, <Table>.AddLine or <TreeView Table>.AddChild: adds a row at the end of the control,
<Table>.Insert, <Table>.InsertLine or <TreeView Table>.InsertChild: adds a row at the specified index or at the current index.

Remark: If the "Cascading input" option is not selected:

The TreeView Table control contains no row when it is created. In this case, no input can be performed. The Empty property is set to True.
To automatically insert a row into an empty TreeView Table control, use <Table>.Add or <Table>.AddLine.

Modifying a row or a column

The content of the rows and columns found in a TreeVview Table control can be modified:

by the user, by performing an input in the columns. The modifications are automatically stored in the TreeView Table control without additional programming. The Modified property is set to True.
by programming:
- with <Table>.Modify or <Table>.ModifyLine to modify the content of the current row or the content of a given row.
  For example:
  
  TVT_CUSTOMER.Modify("MOORE" + TAB + "Vince" + TAB + "Miami")
  
  Remark: You can also use the name of the TreeView Table control directly:
  
  // Modify the current row
  TVT_CUSTOMER = "MOORE" + TAB + "Vince" + TAB + "Miami"
  // Modify the COL_DAY coloumn of row 3
  SHUTDOWN COL_JOUR.Modify("Wednesday"+ TAB + "Vaqué", 3)
- by specifying the column name (like for an edit control) to modify the column content. To modify a column of a specific row, the row number must be specified (index).
  For example:
  
  COL_NAME[Index] = CustomerName
  
  To modify a column of the current row, there is no need to specify the index.
  For example:
  
  COL_NAME = CustomerName
  
  The Modified property is set to False (it is set to True only when data is entered in the TreeView Table control).

Resuming input in a column

ReturnToCapture can be used to resume input in a column, on the current row. For example:

// Event "Entry in" COL_QTY
// COL_QTY cannot be entered if COL_PRODUCT is not entered
IF NoSpace(COL_PRODUCT) = "" THEN
Error("The Product column must be entered first")
ReturnToCapture(COL_PRODUCT)
END

Adding or deleting a column

You can:

add a column into a TreeView Table control with ControlClone.
delete a column from a TreeView Table control with ControlDelete.

Managing calculated columns

The calculation formula of a calculated column must be described in the event "Displaying a table row" of a Table control. For example:

// COL_PBT: calculated column
// COL_UPBT and COL_QTY: columns linked to memory zones
COL_PBT = COL_UPBT * COL_QTY

Operations on the rows and cells

Deleting a row

The deletion of a row must be explicitly requested by <Table>.Delete and <TreeView Table>.DeleteChild.

The syntax used for <Table>.Delete is as follows:

<TreeView Table control>.Delete([<Index>])

If the index is specified, <Table>.Delete deletes the row that corresponds to that index. Otherwise, the current row is deleted.
Deleting a row from the TreeView Table deletes all values of columns for this row.
The syntax used for <TreeView Table>.DeleteChild is as follows:

<TreeView Table control name>.DeleteChild(<Parent element index>)

All child elements of the row identified by the index will be deleted.

Selecting a row

A row can be selected with <Table>.SelectPlus.

The following syntax is used:

<TreeView Table control name>.SelectPlus([, <Index>])

Retrieving the row content or the cell content

The content of a TreeView Table control can be retrieved:

for the entire row.
cell by cell.

Value of a cell in the current row

To retrieve the value of a column (or cell) for the current row, the syntax is the same as for a simple edit control:

For example:

// COL_QTY is a column of a TreeView Table control
IF COL_QTY < 10 THEN
Info("Insufficient quantity")
END

Value of a cell in a specific row

To retrieve the value of a column not found on the current row, the row index must be specified:

<Value> = <Column name>[<Index>]

For example:

// Add the total price before tax (PBT) for all the order lines
TotalPrice = 0
FOR Index = 1 TO TVT_ORDER.Count
TotalPrice = TotalPrice + COL_PBT[Index]
END

Content of current row

To retrieve the content of the current row:

Content of specific row

To retrieve the content of the row whose index is <Index>:

<Value> = <TreeView Table control name>[<Index>]

Remark: the index of the current row is returned by <Table>.Select. For example:

// Retrieve the content from row 10 of the TVT_CUSTOMER TreeView Table control

CurrentRow = TVT_CUSTOMER[10]

// Name of selected customer

CustomerName = COL_NAME[TVT_CUSTOMER.Select()]

// Retrieve the content from the current row of the TVT_CUSTOMER TreeView Table control

CurrentRow = TVT_CUSTOMER

Operations on the tree structure

Collapsing all nodes of a TreeView Table control

To collapse all the nodes of a TreeView Table control, use <Table>.CollapseAll. The syntax used is:

<TreeView Table control name>.CollapseAll()

Expanding all nodes of a TreeView Table control

To expand all the nodes of a TreeView Table control, use <Table>.ExpandAll. The following syntax is used:

Versions 19 and later

Remark: If a delayed sub-level fill mode is enabled on a TreeView Table control via the AddChildDelayed property, the sub-level fill procedure will be executed for each new element expanded.

New in version 19

Remark: If a delayed sub-level fill mode is enabled on a TreeView Table control via the AddChildDelayed property, the sub-level fill procedure will be executed for each new element expanded.

Finding out the number of collapsed/expanded row

To get the number of the row that is expanded or collapsed, simply use the "Collapsed, expanded" code of a node in the TreeView Table control:

// Which row is used?
Info(TVT_TreeviewTable[TVT_TreeviewTable])

Defining the next status during an addition

You have the ability to define the status of the next row that will be added into a TreeView Table control, which means collapsed or expanded. To do so, use the Collapsed property.

// The next added rows will be automatically collapsed
TVT_TreeviewTable..Collapsed = True

Finding out and modifying the images of rows

To find out and modify the images of rows in a TreeView Table control, use the following properties:

ExpandedImage: image of expanded row,
CollapsedImage: image of collapsed row.

// Modify the images of rows in a TreeView Table control
TVT_TreeviewTable.ExpandedImage = "OpenFolder.gif"
TVT_TreeviewTable.CollapsedImage = "ClosedFolder.gif"

Check Box TreeView column

A Check Box column can be defined as "TreeView Table column" in a TreeView Table control. In this case, the Check Box column can be used to manage the tree structure.

The Caption property of the row is used to get and change the text displayed next to the check box. The Value property of the row is used to get and change the value of the check box.

Finding out the parent or the children of an element

The following functions can be used to find out the parent or the children of an element:

<TreeView Table>.GiveParent: Returns the "parent" of an element, which means the element of higher level.
<TreeView Table>.GiveChild: Returns the "children" of an element, which means the elements of lower level.

Properties specific to the TreeView Table controls

The following properties are used to manage the characteristics of a TreeView Table control by programming.


Versions 19 and later AddChildDelayed New in version 19 AddChildDelayed AddChildDelayed	Used to define the procedure that will be called later to fill a branch.
Collapsed	Allows you to define the status (collapsed or expanded) that will be used when adding new rows into a TreeView Table control.
Merge	Used to find out whether the cells (or the titles of columns) found in a TreeView Table control are merged and to merge the cells (or the titles of columns) found in a TreeView Table control.
ExpandedImage	Used to get and change the default image of an expanded row in a TreeView Table control.
CollapsedImage	Used to get and change the default image of a collapsed row in a TreeView Table control.
Multiselection	Used to find out and modify the mode for selecting a TreeView Table control.
Versions 19 and later TotalNbChildren New in version 19 TotalNbChildren TotalNbChildren	Returns the total number of children for a branch in a TreeView Table control.
SortOption	Used to determine and change the sort options defined for a column in a TreeView Table control.
LeftIndent	Used to find out or modify the available space found on the left of text in the columns of TreeView Table control.
BrowsedItem	Allows you to find out and modify the item used for the automatic browse of TreeView Table controls.
Size	Allows you to find out and modify the number of columns in a TreeView Table control.
TotalsEnabled	Allows you to find out the operating mode of automatic calculations in a TreeView Table control and to forbid or force the automatic calculations in a TreeView Table control.

To find out the entire list of WLanguage properties that can be used:

with a TreeView Table control, see Properties associated with a TreeView Table control.
with the rows of a TreeView Table control, see Properties associated with a row in a TreeView Table control