PtContainerNullFocus()

Nullify the focus of a widget

Synopsis:

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

Description:

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

The event argument contains the event that will be passed to the lost-focus callback of the parent widget and any of its children which were part of the focus chain at the time of this function call.

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

Returns:

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

Examples:

See PtContainerGiveFocus().

Classification:

Photon

See also:

PtContainerFocusNext(), PtContainerFocusPrev(), PtContainerGiveFocus()