PtContainerFocusNext()

Give focus to the next Pt_GETS_FOCUS widget

Synopsis:

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

Description:

This function gives focus to the next widget that has Pt_GETS_FOCUS set in its Pt_ARG_FLAGS and is in the same container as the currently focused widget in widget's family. If no widget has the Pt_GETS_FOCUS flag set, the container's focus is nullified (that is, none of its children will have focus).

The event argument contains the event that's passed to the lost-focus callback of the widget losing focus and to the got-focus callback of the widget getting focus.

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

Returns:

A pointer to the newly focused widget.

Examples:

See PtContainerGiveFocus().

Classification:

Photon

See also:

PtContainerFocusPrev(), PtContainerGiveFocus(), PtContainerNullFocus()