PtFindChildClassMember()

Find the first descendant that's a subclass of the specified class

Synopsis:

PtWidget_t *PtFindChildClassMember( 
                  PtWidgetClassRef_t *class,
                  PtWidget_t *widget );

Library:

ph

Description:

This function searches the widget family hierarchy of the given container, widget, for a descendant widget that's a subclass of the specified class. For example, PtMultiText, PtText, PtButton, and PtLabel are all subclasses of PtLabel.

---

Some container widgets, including PtDivider, PtMenuBar, PtMultiText, and PtScrollArea redirect children to an alternate parent. For all container widgets, it's best to call PtValidParent() to determine the “real” parent of the children. For example, to find a subclass of PtLabel in a PtScrollArea: child = PtFindChildClassMember( PtLabel, PtValidParent( my_scrollarea, PtLabel ));

---

Returns:

A pointer to a PtWidget_t structure, or NULL if an error occurs.

Examples:

See PtFindChildClass().

Classification:

Photon

See also:

PtWidgetBrotherBehind(), PtWidgetBrotherInFront(), PtWidgetChildBack(), PtWidgetFamily(), PtWidgetParent()