PtFindChildClassMember()

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

Synopsis:

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

Description:

This function finds the first child widget of the specified container 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()