AddChildDelayed (Property)

The property AddsDifferenceStrings indicates the Procedure to call when clicking on the row of an TreeView control or an TreeView Table control. This procedure is used to fill the expanded branches only.

Therefore, the procedure for filling the control can be optimized.

Remark: To optimize the filling of browsing TreeView and TreeView Table controls, check "Delayed fill of sub-levels (faster)" in the "Content" tab of the control description window.

Example

sDir is string = fListDirectory("C:", frNotRecursive)
FOR EACH STRING sADir OF sDir SEPARATED BY CR
nLine is int = TableAddLine(TVT_Explorer, sADir)
// If this directory has children
sChild is string = fListDirectory(sADir, frNotRecursive)
IF sChild <> "" THEN
// Call to the AddDirectory procedure
// when the user clicks [+]
TABLEH_EXPLORER [nLine].AddSpreadWires = AddDirectory
END
END

PROCEDURE AddDirectory(sParentID is string)
nSubscript is int

sParentDir is string = TVT_Explorer.COL_NoName1[sParentID]
sParentDir = Replace(sParentDir, TAB, fSep())
sDirList is string = fListDirectory(sParentDir, frNotRecursive)
nSubscript = Val(sParentID) + 1
nSubscript2 is int = nSubscript
FOR EACH STRING sDir OF sDirList SEPARATED BY CR
sID is string = Replace(sDir, "\", TAB)
TableAddChild(TVT_Explorer, nSubscript-1, sDir)
sSubDirList is string = fListDirectory(sDir, frNotRecursive)
IF sSubDirList <> "" THEN
TABLEH_EXPLORER [nIndex2].AddsDifferedStrand = AddsDirectory
END
nSubscript2 = nSubscript2 + 1
END

Syntax

Modifying the procedure to run Hide the details

<Element>.AddChildDelayed = <WLanguage procedure>

<Element>: Character string

Row of the Table or Treeview Table control to use.

<WLanguage procedure>: Procedure name

Name of the WLanguage procedure that will be run during the click on the element.
For TreeView controls, the procedure has the following format:

PROCEDURE <Procedure name>(<ParentPath> is string)

where <ParentPath> corresponds to the full path of the row to expand.
For TreeView Table controls, the procedure has the following format:

PROCEDURE <Procedure name>(<ParentID> is int)

where <ParentID> corresponds to the number of the row to expand.
If this parameter corresponds to an empty string (""), no procedure will be associated with the element.

Remarks

Operating mode

If the property AddChildDelayed corresponds to the name of an Procedure:

a "+" sign is displayed on the row in the control.
the first time the user tries to expand the row (by clicking the "+" sign for example), the procedure is called, allowing to add child elements. Then, the branch is expanded.
If no child element is added, the "+" sign is deleted from the element.

Once the Procedure has been executed (the branch has been filled), the Property AddChildDelayed is assigned with a string Void: it will not be run anymore.

Special cases

The specified procedure will be run BEFORE the "Collapsing, expanding a node" event of the control.
When calling the TableExpand or TreeExpand function, if the specified branch has an Procedure associated by the AddChildDelayedproperty, this Procedure will be executed..
Versions 20 and later
When calling the TableExpandAll or TreeExpandAll function, if the specified branch and/or its wires have an Procedure associated by the AddChildDelayedproperty, this Procedure will be executed..
New in version 20
When calling the TableExpandAll or TreeExpandAll function, if the specified branch and/or its wires have an Procedure associated by the AddChildDelayedproperty, this Procedure will be executed..
When calling the TableExpandAll or TreeExpandAll function, if the specified branch and/or its wires have an Procedure associated by the AddChildDelayedproperty, this Procedure will be executed..