PtGlobalFocusNextContainer()

Give focus to another container's widget

Synopsis:

PtWidget_t *PtGlobalFocusNextContainer( 
                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 in a different container.

The widget that's given focus receives the given 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

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

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