Community articleUFLGetNext function
Added by IBM contributorIBM on May 2, 2012
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

No abstract provided.


This function, along with UFLGetPrevious, is used to traverse horizontally along the form hierarchy. UFLGetNext returns the next node in the tree. For instance, the page node corresponding to the first page of your form can be reached by calling UFLGetNext on the global page node.


   formNodeP UFLGetNext(
      formNodeP theFormNode


Table 1. Function parameters
theFormNodeformNodePThe formNodeP to retrieve the next node from.


The formNodeP that represents the next node or NULL if the next node does not exist.


The following example uses UFLGetNext in a while loop to horizontally traverse across the form hierarchy until the last node on the branch is reached. The last node is returned.
   formNodeP getLastNode(formNodeP *theNode)
   formNodeP theLastNode = NULL;
   formNodeP theNextNode;
      if(*theNode != NULL)
         theNextNode = UFLGetNext(*theNode);
      while (theNextNode != NULL)
         theLastNode = theNextNode;
         theNextNode = UFLGetNext(theNextNode);
      return theLastNode;

Parent topic:
FormNodeP functions