<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /tmp/qt-3.0-reggie-28534/qt-x11-free-3.0.2/src/kernel/qevent.cpp:1008 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>QFocusEvent Class</title>
<style type="text/css"><!--
h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
--></style>
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
<a href="index.html">
<font color="#004faf">Home</font></a>
| <a href="classes.html">
<font color="#004faf">All Classes</font></a>
| <a href="mainclasses.html">
<font color="#004faf">Main Classes</font></a>
| <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
| <a href="groups.html">
<font color="#004faf">Grouped Classes</font></a>
| <a href="functions.html">
<font color="#004faf">Functions</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>QFocusEvent Class Reference</h1>
<p>The QFocusEvent class contains event parameters for widget focus
events.
<a href="#details">More...</a>
<p><tt>#include <<a href="qevent-h.html">qevent.h</a>></tt>
<p>Inherits <a href="qevent.html">QEvent</a>.
<p><a href="qfocusevent-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li><div class=fn><a href="#QFocusEvent"><b>QFocusEvent</b></a> ( Type type )</div></li>
<li><div class=fn>bool <a href="#gotFocus"><b>gotFocus</b></a> () const</div></li>
<li><div class=fn>bool <a href="#lostFocus"><b>lostFocus</b></a> () const</div></li>
<li><div class=fn>enum <a href="#Reason-enum"><b>Reason</b></a> { Mouse, Tab, Backtab, ActiveWindow, Popup, Shortcut, Other }</div></li>
</ul>
<h2>Static Public Members</h2>
<ul>
<li><div class=fn>Reason <a href="#reason"><b>reason</b></a> ()</div></li>
<li><div class=fn>void <a href="#setReason"><b>setReason</b></a> ( Reason reason )</div></li>
<li><div class=fn>void <a href="#resetReason"><b>resetReason</b></a> ()</div></li>
</ul>
<hr><a name="details"></a><h2>Detailed Description</h2>
The QFocusEvent class contains event parameters for widget focus
events.
<p> Focus events are sent to widgets when the keyboard input focus
changes. Focus events occur due to mouse actions, keypresses (e.g. Tab
or Backtab), the window system, popup menus, keyboard shortcuts or
other application specific reasons. The reason for a particular focus
event is returned by <a href="#reason">reason</a>() in the appropriate event handler.
<p> The event handlers <a href="qwidget.html#focusInEvent">QWidget::focusInEvent</a>() and <a href="qwidget.html#focusOutEvent">QWidget::focusOutEvent</a>()
receive focus events.
<p> Use <a href="#setReason">setReason</a>() to set the reason for all focus events, and
<a href="#resetReason">resetReason</a>() to set the reason for all focus events to the reason in
force before the last setReason() call.
<p> <p>See also <a href="qwidget.html#setFocus">QWidget::setFocus</a>(), <a href="qwidget.html#focusPolicy-prop">QWidget::focusPolicy</a> and <a href="events.html">Event Classes</a>.
<hr><h2>Member Type Documentation</h2>
<h3 class=fn><a name="Reason-enum"></a>QFocusEvent::Reason</h3>
<p> This enum specifies why the focus changed:
<ul>
<li><tt>QFocusEvent::Mouse</tt> - because of a mouse action.
<li><tt>QFocusEvent::Tab</tt> - because of a Tab press
<li><tt>QFocusEvent::Backtab</tt> - because of a Backtab press
(possibly including Shift/Control, e.g. Shift+Tab).
<li><tt>QFocusEvent::ActiveWindow</tt> - because the window system made this window (in)active.
<li><tt>QFocusEvent::Popup</tt> - because the application opened/closed a popup that grabbed/released focus.
<li><tt>QFocusEvent::Shortcut</tt> - because of a keyboard shortcut.
<li><tt>QFocusEvent::Other</tt> - any other reason, usually application-specific.
</ul><p> See the <a href="focus.html#keyboard-focus">keyboard focus</a> overview for more about focus.
<hr><h2>Member Function Documentation</h2>
<h3 class=fn><a name="QFocusEvent"></a>QFocusEvent::QFocusEvent ( <a href="qevent.html#Type-enum">Type</a> type )
</h3>
Constructs a focus event object.
<p> The <em>type</em> parameter must be either <a href="qevent.html#Type-enum">QEvent::FocusIn</a> or <a href="qevent.html#Type-enum">QEvent::FocusOut</a>.
<h3 class=fn>bool <a name="gotFocus"></a>QFocusEvent::gotFocus () const
</h3>
Returns TRUE if the widget received the text input focus; otherwise
returns FALSE.
<h3 class=fn>bool <a name="lostFocus"></a>QFocusEvent::lostFocus () const
</h3>
Returns TRUE if the widget lost the text input focus; otherwise returns FALSE.
<h3 class=fn><a href="qfocusevent.html#Reason-enum">Reason</a> <a name="reason"></a>QFocusEvent::reason ()<tt> [static]</tt>
</h3>
Returns the reason for this focus event.
<p> <p>See also <a href="#setReason">setReason</a>().
<h3 class=fn>void <a name="resetReason"></a>QFocusEvent::resetReason ()<tt> [static]</tt>
</h3>
Resets the reason for all future focus events to the value before
the last <a href="#setReason">setReason</a>() call.
<p> <p>See also <a href="#reason">reason</a>() and <a href="#setReason">setReason</a>().
<h3 class=fn>void <a name="setReason"></a>QFocusEvent::setReason ( <a href="qfocusevent.html#Reason-enum">Reason</a> reason )<tt> [static]</tt>
</h3>
Sets the reason for all future focus events to <em>reason</em>.
<p> <p>See also <a href="#reason">reason</a>() and <a href="#resetReason">resetReason</a>().
<!-- eof -->
<hr><p>
This file is part of the <a href="index.html">Qt toolkit</a>.
Copyright © 1995-2001
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright © 2001
<a href="http://www.trolltech.com">Trolltech</a><td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td align=right><div align=right>Qt version 3.0.2</div>
</table></div></address></body>
</html>
distrib
>
Mandriva
>
8.2
>
i586
>
media
>
contrib
>
by-pkgid
>
112b0974ad288f6cd55bf971ee6026a9
>
files
>
1290
