Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/wid_build/libs/ptwidgetabove.html on line 1

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/wid_build/libs/ptwidgetabove.html on line 1

Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/wid_build/libs/ptwidgetabove.html on line 8

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/wid_build/libs/ptwidgetabove.html on line 8

PtWidgetAbove()

Get the widget that's above a given widget in a family hierarchy

Synopsis:

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

Arguments:

root
A pointer to the highest widget that you want to consider in the widget family hierarchy.
widget
A pointer to the widget for which you want to find a widget above.

Description:

This function returns a pointer to the widget that's in front of widget, provided the returned widget isn't any higher in the widget family hierarchy than root.

PtWidgetAbove() skips any disjoint widgets that it finds as it traverses the hierarchy.

Returns:

A pointer to the widget above, or NULL if there isn't one. If widget is the same as root, the function returns the first child of root, or NULL if root has no children.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtWidgetBrotherBehind(), PtWidgetBrotherInFront(), PtWidgetChildBack(), PtWidgetChildFront(), PtWidgetFamily(), PtWidgetParent(), PtWidgetTree(), PtWidgetTreeTraverse() in the Photon Library Reference


Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/wid_build/libs/ptwidgetabove.html on line 113

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/wid_build/libs/ptwidgetabove.html on line 113