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.

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

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