PtSurfaceToBack(), PtSurfaceToBackById()

Move a control surface behind all other control surfaces belonging to a widget

Synopsis:

int PtSurfaceToBack( PtWidget_t *widget,
                     PtSurface_t *surface );

int PtSurfaceToBackById( PtWidget_t *widget,
                         unsigned char surface_id );

Library:

ph

Description:

These functions move a control surface behind all other control surfaces belonging to the given widget. They differ in how they identify the control surface:

PtSurfaceToBack()
Uses the surface argument, which points to a PtSurface_t structure that describes the control surface. This pointer must not be NULL.
PtSurfaceToBackById()
Searches the control surfaces belonging to the widget for the one with an ID of surface_id.

Returns:

0
Success.
-1
The specified surface couldn't be found.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtInsertSurface(), PtInsertSurfaceById(), PtSurfaceBrotherBehind(), PtSurfaceBrotherInFront(), PtSurfaceInBack(), PtSurfaceInFront(), PtSurfaceToFront(), PtSurfaceToFrontById()

Control Surfaces chapter of the Photon Programmer's Guide