This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

PtWidgetToFront()

Move a widget in front of all its brothers

Synopsis:

int PtWidgetToFront( PtWidget_t *widget );

Library:

ph

Description:

This function moves the specified widget in front of all its brothers (i.e. toward 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 front of the workspace, use PtWindowToFront(), which is described in the Photon Widget Reference.

Returns:

0

Successful completion.

-1

An error occurred.

Examples:

See PtWidgetToBack().

Classification:

Photon

See also:

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

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

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