You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tqt3/doc/html/qfocusevent.html

134 lines
6.0 KiB

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/kernel/qevent.cpp:1147 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>TQFocusEvent Class</title>
<style type="text/css"><!--
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&nbsp;Classes</font></a>
| <a href="mainclasses.html">
<font color="#004faf">Main&nbsp;Classes</font></a>
| <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
| <a href="groups.html">
<font color="#004faf">Grouped&nbsp;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>TQFocusEvent Class Reference</h1>
<p>The TQFocusEvent class contains event parameters for widget focus
events.
<a href="#details">More...</a>
<p><tt>#include &lt;<a href="qevent-h.html">ntqevent.h</a>&gt;</tt>
<p>Inherits <a href="ntqevent.html">TQEvent</a>.
<p><a href="qfocusevent-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li class=fn><a href="#TQFocusEvent"><b>TQFocusEvent</b></a> ( Type&nbsp;type )</li>
<li class=fn>bool <a href="#gotFocus"><b>gotFocus</b></a> () const</li>
<li class=fn>bool <a href="#lostFocus"><b>lostFocus</b></a> () const</li>
<li class=fn>enum <a href="#Reason-enum"><b>Reason</b></a> { Mouse, Tab, Backtab, ActiveWindow, Popup, Shortcut, Other }</li>
</ul>
<h2>Static Public Members</h2>
<ul>
<li class=fn>Reason <a href="#reason"><b>reason</b></a> ()</li>
<li class=fn>void <a href="#setReason"><b>setReason</b></a> ( Reason&nbsp;reason )</li>
<li class=fn>void <a href="#resetReason"><b>resetReason</b></a> ()</li>
</ul>
<hr><a name="details"></a><h2>Detailed Description</h2>
The TQFocusEvent class contains event parameters for widget focus
events.
<p>
<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="ntqwidget.html#focusInEvent">TQWidget::focusInEvent</a>() and
<a href="ntqwidget.html#focusOutEvent">TQWidget::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="ntqwidget.html#setFocus">TQWidget::setFocus</a>(), <a href="ntqwidget.html#focusPolicy-prop">TQWidget::focusPolicy</a>, and <a href="events.html">Event Classes</a>.
<hr><h2>Member Type Documentation</h2>
<h3 class=fn><a name="Reason-enum"></a>TQFocusEvent::Reason</h3>
<p> This enum specifies why the focus changed.
<ul>
<li><tt>TQFocusEvent::Mouse</tt> - because of a mouse action.
<li><tt>TQFocusEvent::Tab</tt> - because of a Tab press.
<li><tt>TQFocusEvent::Backtab</tt> - because of a Backtab press
(possibly including Shift/Control, e.g. Shift+Tab).
<li><tt>TQFocusEvent::ActiveWindow</tt> - because the window system made this window (in)active.
<li><tt>TQFocusEvent::Popup</tt> - because the application opened/closed a popup that grabbed/released focus.
<li><tt>TQFocusEvent::Shortcut</tt> - because of a keyboard shortcut.
<li><tt>TQFocusEvent::Other</tt> - any other reason, usually application-specific.
</ul><p> See the <a href="focus.html">keyboard focus overview</a> for more
about focus.
<hr><h2>Member Function Documentation</h2>
<h3 class=fn><a name="TQFocusEvent"></a>TQFocusEvent::TQFocusEvent ( <a href="ntqevent.html#Type-enum">Type</a>&nbsp;type )
</h3>
<p> Constructs a focus event object.
<p> The <em>type</em> parameter must be either <a href="ntqevent.html#Type-enum">TQEvent::FocusIn</a> or <a href="ntqevent.html#Type-enum">TQEvent::FocusOut</a>.
<h3 class=fn>bool <a name="gotFocus"></a>TQFocusEvent::gotFocus () const
</h3>
<p> Returns TRUE if the widget received the text input focus;
otherwise returns FALSE.
<h3 class=fn>bool <a name="lostFocus"></a>TQFocusEvent::lostFocus () const
</h3>
<p> 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>TQFocusEvent::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>TQFocusEvent::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>TQFocusEvent::setReason ( <a href="qfocusevent.html#Reason-enum">Reason</a>&nbsp;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">TQt toolkit</a>.
Copyright &copy; 1995-2007
<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 &copy; 2007
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
<td align=right><div align=right>TQt 3.3.8</div>
</table></div></address></body>
</html>