Go Back

User login

Frontpage Sponsor


Google search

For ERP LN feature pack upgrade, what method of install are you using?
Installation Wizard into existing VRC
Installation Wizard into new VRC
Manual into existing VRC
Manual into new VRC
Total votes: 49

Baanboard at LinkedIn

Reference Content

By patvdv at 26 Feb 2008 - 21:57



long gbf.get.first.child( long, long, ref long, ref string child.key(), ref long child.value, ref long


This function returns the first child of the given object if the children are read by the GBF (see below). The returned is the GBF child identification, to be used on subsequent gbf.get.parent(), gbf.get.first.child(), and gbf.update.object() function calls. The child is further identified by the child.key and child.value, which have been given to the GBF on a preceding gbf.add.object() call.

If the has no children at all, then GBF.NO.CHILDREN will be returned (and of course the other return values, such as and so on. will not contain any valid information).


The tells the GBF what to do when the children are not yet read



First the children are read, using the gbf.get.children() function call, and the first read child is returned by this gbf.get.first.child() call as described above.

That is, in this case it does not matter whether or not the children are already read before the main application issued this call (except for the GBF.NO.MEMORY return call).


The special return value GBF.NO.READ.CHILDREN is returned, and of course the, child.key, child.value and obj.type are all invalid and should not be used

A very special value of may be used to indicate that the first child of the root object should be used. This special value is: GBF.ROOT.OBJECT. In this case an object which has been given to the GBF on the preceding gbf.add.object() from within the will be returned. The special successful completion return value GBF.LAST indicates that the object returned is the only child object, which means that this child object has no further brothers, or in other words cannot be used in a subsequent function call.


This function should not be used during a refresh, so not during a or a gbf.get.children() since that may lead to unpredictable results when, for example, using this function to get the children of the object for which the gbf.get.children() was started in the first place. Not refreshed children (in other words the dirty children) will not be returned.


The unique object identification.

Tells the GBF what to do when the children are not yet read. See table above with an explanation.

Returns the unique child (object) identification.


Returns the key of the child (object) by which it is known in the application.


Returns the value of the child (object) that is used to further identify this object (in case the object is more than once in the tree).

Note that a value of 0 means something special, see gbf.update.object().


The type of node

  • GBF.HEADER the returned is a header node
  • GBF.INTERIOR the returned is an interior node.
  • GBF.LEAF the returned is a leaf node

Return values


Successful completion


Successful completion, but reflects the same object as in this subtree due to a cycle.


Successful completion, and is the only child


Successful completion, but does not have any children


Successful completion, but the children of are not yet read


Illegal given


GBF is not in the right state to deal with this function


Not enough memory to store all children


Given is not an interior node, so it has no children

Related topics

No votes yet

All times are GMT +2. The time now is 19:46.

©2001-2018 - -