PtContainerFocusNext()

Give focus to the next Pt_GETS_FOCUS widget

Synopsis:

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

Library:

ph

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 is a pointer to a PhEvent_t structure that describes 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 is NULL, this function generates a PhEvent_t structure filled with zeros for you.

Returns:

A pointer to the newly focused widget.

Examples:

See PtContainerGiveFocus().

Classification:

Photon

See also:

PhEvent_t, PtContainerFocusPrev(), PtContainerGiveFocus(), PtContainerNullFocus()