---

PtGetParent()

Find the nearest parent widget that matches the specified class

Synopsis:

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

Library:

ph

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 no parent was found.

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

Safety:
Interrupt handler	No
Signal handler	No
Thread	No

See also:

PtSetParentWidget(), PtWidgetParent()

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

---