Community articleUFLGetNext function
Added by IBM contributorIBM on August 16, 2011
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

No abstract provided.



Description

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.

Function

   formNodeP UFLGetNext(
      formNodeP theFormNode
   );


Parameters

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


Returns

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

Example

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)
      {
         reportNodeInfo(&theNextNode);
         theLastNode = theNextNode;
         theNextNode = UFLGetNext(theNextNode);
      }
      return theLastNode;
   }


Parent topic:
FormNodeP functions