PtGlobalFocusNext()

Give focus to next widget

Synopsis:

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

Library:

ph

Description:

This function finds the currently focused widget in the same disjoint widget (window, region, menu) as widget and moves the focus to the next focusable widget.

The widget that's given focus receives the event described in the given PhEvent_t structure 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

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

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