PtGlobalFocusNextContainer()

Give focus to another container's widget

Synopsis:

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

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 in a different container. The widget that's given focus will receive event as the reason.

If event isn't provided, a NULL event will be generated for you.

Returns:

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

Classification:

Photon

See also:

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