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

PtGlobalFocusNextFrom()

Give focus to the next widget behind the specified widget

Synopsis:

PtWidget_t *PtGlobalFocusNextFrom( 
                PtWidget_t *widget, 
                PhEvent_t *event ); 

Library:

ph

Description:

Unlike PtGlobalFocusNext(), this function doesn't find the currently focused widget first. PtGlobalFocusNextFrom() moves the focus to the next focusable widget after widget in the same disjoint widget (window, region, menu) as widget.

The widget that's given focus receives event as the reason. If event is NULL, this function generates a PhEvent_t structure filled with zeros for you.

Returns:

The widget that was given focus, or NULL if no focusable widgets are found.

Classification:

Photon

See also:

PhEvent_t, PtContainerGiveFocus(), PtContainerNullFocus(), PtContainerFocusNext(), PtContainerFocusPrev(), PtGlobalFocusNext(), PtGlobalFocusNextContainer(), PtGlobalFocusPrev(), PtGlobalFocusPrevFrom(), PtGlobalFocusPrevContainer(), PtIsFocused()