Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

PtWidgetSkip()

Skip to a widget in the next hierarchy

Synopsis:

PtWidget_t * PtWidgetSkip( PtWidget_t *root, 
                           PtWidget_t *widget );

Library:

ph

Description:

This function skips the hierarchy rooted at widget but does not return widgets any higher than root.

Returns:

A pointer to a widget in the next hierarchy, or NULL if there isn't another hierarchy to skip to.

Examples:

// Set the fill color of all REALIZED widgets to white.

PtArg_t argt;
int flags, skip = 0;
PtSetArg( &argt, Pt_ARG_FILL_COLOR, Pt_WHITE, 0 );

  for( wp = widget;  wp;  
       wp = skip ? PtWidgetSkip(root, wp )
                 : PtWidgetFamily( root, wp )  ){
     skip = 0;
     flags = PtWidgetFlags( wp );

     if( !( flags & Pt_REALIZED ) ) {
       // completely skip this hierarchy.
       skip = 1;
       continue;
     }
  PtSetResources( wp, 1, &argt );
}

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtNextTopLevelWidget(), PtWidgetBrotherBehind(), PtWidgetBrotherInFront(), PtWidgetChildBack(), PtWidgetChildFront(), PtWidgetFamily(), PtWidgetTree(), PtWidgetTreeTraverse()

"Ordering widgets" in the Managing Widgets in Application Code chapter of the Photon Programmer's Guide