Qt Toolkit - QFocusEvent Class

| Classes - Annotated - Tree - Functions - Home - Structure

# QFocusEvent Class Reference

The QFocusEvent class contains event parameters for widget focus events. More...

`#include <qevent.h>`

Inherits QEvent.

List of all member functions.

## Public Members

- QFocusEvent ( Type type )
- bool gotFocus () const
- bool lostFocus () const
- enum Reason { Mouse, Tab, ActiveWindow, Popup, Shortcut, Other }

## Static Public Members

- Reason reason ()
- void setReason ( Reason reason )
- void resetReason ()

## Detailed Description

The QFocusEvent class contains event parameters for widget focus events.

Focus events are sent to widgets when the keyboard input focus changes. This happens due to either a mouse action, the tab key, the window system, a keyboard shortcut or some other application specific issue. The actual reason for a specific event is obtained by reason() in the appropriate event handler.

The event handlers QWidget::focusInEvent() and QWidget::focusOutEvent() receive focus events.

See also QWidget::setFocus() and QWidget::setFocusPolicy().

Examples: qmag/qmag.cpp

## Member Type Documentation

### QFocusEvent::Reason

- `Mouse` - the focus change happened because of a mouse action
- `Tab` - the focus change happened because of a Tab press (possibly including shift/control)
- `ActiveWindow` - the window system made this window (in)active
- `Popup` - the application opened/closed a popup that grabbed/released focus
- `Shortcut` - the focus change happened because of a keyboard shortcut
- `Other` - any other reason, usually application-specific

See the focus overview for more about focus.

## Member Function Documentation

### QFocusEvent::QFocusEvent ( Type type )

Constructs a focus event object.

The type parameter must be either QEvent::FocusIn or QEvent::FocusOut.

### bool QFocusEvent::gotFocus () const

Returns TRUE if the widget received the text input focus.

### bool QFocusEvent::lostFocus () const

Returns TRUE if the widget lost the text input focus.

### QFocusEvent::Reason QFocusEvent::reason() `[static]`

Returns the reason for this focus event.

See also setReason().

### void QFocusEvent::resetReason () `[static]`

Resets the reason for all future focus events to the value before the last setReason() call.

See also reason() and setReason().

### void QFocusEvent::setReason ( Reason reason ) `[static]`

Sets the reason for all future focus events to reason.

See also reason() and resetReason().

Search the documentation, FAQ, qt-interest archive and more (uses www.trolltech.com):

This file is part of the Qt toolkit, copyright © 1995-2001 Trolltech, all rights reserved.