[Previous] [Contents] [Index] [Next]

PtWidgetToBack()

Move a widget behind all its brothers

Synopsis:

int PtWidgetToBack( PtWidget_t *widget );

Description:

This function moves the specified widget behind all its brothers (i.e. away from the user). All of widget's children are moved too. Any widgets damaged as a result of this operation are automatically repaired.


Note: This function doesn't work for PtWindow widgets - their positions are controlled by the Window Manager. To move a window to the back of the workspace, use PtWindowToBack(), which is described in the Photon Widget Reference.

Returns:

0
Successful completion.
-1
An error occurred.

Examples:

See PtWidgetChildBack().

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtWidgetBrotherBehind(), PtWidgetBrotherInFront(), PtWidgetChildBack(), PtWidgetChildFront(), PtWidgetInsert(), PtWidgetParent(), PtWidgetToFront()

PtWindowToBack() PtWindowToFront() in the Photon Widget Reference.

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


[Previous] [Contents] [Index] [Next]