Give focus to the next Pt_GETS_FOCUS widget
PtWidget_t *PtContainerFocusNext( PtWidget_t *widget, PhEvent_t *event );
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.
A pointer to the newly focused widget.
PhEvent_t, PtContainerFocusPrev(), PtContainerGiveFocus(), PtContainerNullFocus()