PtGetParent()

Find the nearest widget with the same parent class

Synopsis:

PtWidget_t *PtGetParent( 
                PtWidget_t *widget,
                PtWidgetClassRef_t *parent_class );

Description:

This function examines the specified widget's hierarchy, and tries to find the nearest widget in the hierarchy (including the specified widget itself) that matches the specified parent class.

Returns:

A pointer to the matching widget, or NULL if an error occurs.

Examples:

PtWidget_t   *window;

// Get main window widget and make it a parent for drawing.

window = PtGetParent( widget, PtWindow );
PtSetParentWidget( window );
PgSetRegion( PtWidgetRid(window) );

Classification:

Photon

See also:

PtSetParentWidget(), PtWidgetParent()

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