TableGiveChild (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

TableGiveChild (Function)

In french: TableRécupèreFils

Returns the "children" of an element (lower level) in a TreeView Table control.

Example

// First "child" of first node in the "TVT_RecipeTV" control
Res is int
Res = TableGiveChild(TVT_RecipeTV, 1, taFirst)
WHILE Res <> -1
Trace(Res)
Res = TableGiveChild(TVT_RecipeTV, 1, taNext)
END

// Recursive procedure used to list all children
// of all parents from a row
PROCEDURE ListChildren(i=0)
j is int
// If no row number was passed in parameter,
// gets the subscript of selected row
IF i = 0 THEN i = TableSelect(TVT_MyTreeViewTable)
j = TableGiveChild(TVT_MyTreeViewTable, i, taFirst)
WHILE j <> -1
Info("Row: " + j + ", Code: " + COL_Code[j])
// Call the procedure by specifying
// the current row number
ListChildren(j)
j = TableGiveChild(TVT_MyTreeViewTable, i, taNext)
END

Syntax

Returning the child of an element by specifying the row number Hide the details

<Result> = TableGiveChild(<TreeView Table control> , <Row number> , <Child>)

<Result>: Integer

Number of the row for the "child" that was found,
-1 if no "child" is found.

<TreeView Table control>: Control name

Name of TreeView Table control to use.

<Row number>: Integer

Number of the row containing the branch to use.

<Child>: Constant

Indicates the requested "child".
taFirst First child element.
taNext Next child element.

Returning the child of an element by specifying its name Hide the details

<Result> = TableGiveChild(<TreeView Table control> [, <Element name>] , <Child>)

<Result>: Integer

Number of the row for the "child" that was found,
-1 if no "child" is found.

<TreeView Table control>: Control name

Name of TreeView Table control to use.

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

Name of element to use. This parameter has the following format:

"<Name of root>" + TAB + ["<Name of 1st node>" + TAB + ...
["<Name of 2nd node>" + TAB + [...]]]"<Element name>"

A WLanguage error occurs if this parameter does not correspond to an existing element.

<Child>: Constant

Indicates the requested "child".
taFirst First child element.
taNext Next child element.

Remarks

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

Component : wd250obj.dll