PtContainerNullFocus()

Nullify the focus of a widget

Synopsis:

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

Library:

ph

Description:

This function nullifies the focus of the specified widget's parent. As a result, none of parent's children has focus.

The event argument is a pointer to a PhEvent_t, structure that describes the event to be passed to the lost-focus callback of the parent widget and any of its children that were part of the focus chain at the time of this function call.

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

Returns:

A pointer to the widget where the focus chain stops. On successful completion, this is widget's parent.

Examples:

See PtContainerGiveFocus().

Classification:

Photon

See also:

PhEvent_t, PtContainerFocusNext(), PtContainerFocusPrev(), PtContainerGiveFocus()