This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

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 is NULL, this function generates a PhEvent_t structure filled with zeros 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()