diff options
Diffstat (limited to 'doc/html/qfocusdata.html')
| -rw-r--r-- | doc/html/qfocusdata.html | 123 |
1 files changed, 123 insertions, 0 deletions
diff --git a/doc/html/qfocusdata.html b/doc/html/qfocusdata.html new file mode 100644 index 0000000..0be703f --- /dev/null +++ b/doc/html/qfocusdata.html @@ -0,0 +1,123 @@ +<!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/qfocusdata.cpp:40 --> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> +<title>QFocusData 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 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>QFocusData Class Reference</h1> + +<p>The QFocusData class maintains the list of widgets in the focus +chain. +<a href="#details">More...</a> +<p><tt>#include <<a href="qfocusdata-h.html">qfocusdata.h</a>></tt> +<p><a href="qfocusdata-members.html">List of all member functions.</a> +<h2>Public Members</h2> +<ul> +<li class=fn>QWidget * <a href="#focusWidget"><b>focusWidget</b></a> () const</li> +<li class=fn>QWidget * <a href="#home"><b>home</b></a> ()</li> +<li class=fn>QWidget * <a href="#next"><b>next</b></a> ()</li> +<li class=fn>QWidget * <a href="#prev"><b>prev</b></a> ()</li> +<li class=fn>QWidget * <a href="#first"><b>first</b></a> () const</li> +<li class=fn>QWidget * <a href="#last"><b>last</b></a> () const</li> +<li class=fn>int <a href="#count"><b>count</b></a> () const</li> +</ul> +<hr><a name="details"></a><h2>Detailed Description</h2> + + +The QFocusData class maintains the list of widgets in the focus +chain. +<p> +<p> This read-only list always contains at least one widget (i.e. the +top-level widget). It provides a simple cursor which can be reset +to the current focus widget using <a href="#home">home</a>(), or moved to its +neighboring widgets using <a href="#next">next</a>() and <a href="#prev">prev</a>(). You can also retrieve +the <a href="#count">count</a>() of the number of widgets in the list. The list is a +loop, so if you keep iterating, for example using next(), you will +never come to the end. +<p> Some widgets in the list may not accept focus. Widgets are added +to the list as necessary, but not removed from it. This lets +widgets change focus policy dynamically without disrupting the +focus chain the user experiences. When a widget disables and +re-enables tab focus, its position in the focus chain does not +change. +<p> When reimplementing <a href="qwidget.html#focusNextPrevChild">QWidget::focusNextPrevChild</a>() to provide +special focus flow, you will usually call <a href="qwidget.html#focusData">QWidget::focusData</a>() to +retrieve the focus data stored at the top-level widget. A +top-level widget's focus data contains the focus list for its +hierarchy of widgets. +<p> The cursor may change at any time. +<p> This class is <em>not</em> thread-safe. +<p> <p>See also <a href="qwidget.html#focusNextPrevChild">QWidget::focusNextPrevChild</a>(), <a href="qwidget.html#setTabOrder">QWidget::setTabOrder</a>(), <a href="qwidget.html#focusPolicy-prop">QWidget::focusPolicy</a>, and <a href="misc.html">Miscellaneous Classes</a>. + +<hr><h2>Member Function Documentation</h2> +<h3 class=fn>int <a name="count"></a>QFocusData::count () const +</h3> + +<p> Returns the number of widgets in the focus chain. + +<h3 class=fn><a href="qwidget.html">QWidget</a> * <a name="first"></a>QFocusData::first () const +</h3> +Returns the first widget in the focus chain. +The cursor is not modified. + +<h3 class=fn><a href="qwidget.html">QWidget</a> * <a name="focusWidget"></a>QFocusData::focusWidget () const +</h3> + +<p> Returns the widgets in the hierarchy that are in the focus chain. + +<h3 class=fn><a href="qwidget.html">QWidget</a> * <a name="home"></a>QFocusData::home () +</h3> +Moves the cursor to the <a href="#focusWidget">focusWidget</a>() and returns that widget. You +must call this before <a href="#next">next</a>() or <a href="#prev">prev</a>() to iterate meaningfully. + +<h3 class=fn><a href="qwidget.html">QWidget</a> * <a name="last"></a>QFocusData::last () const +</h3> +Returns the last widget in the focus chain. +The cursor is not modified. + +<h3 class=fn><a href="qwidget.html">QWidget</a> * <a name="next"></a>QFocusData::next () +</h3> +Moves the cursor to the next widget in the focus chain. There is +<em>always</em> a next widget because the list is a loop. + +<h3 class=fn><a href="qwidget.html">QWidget</a> * <a name="prev"></a>QFocusData::prev () +</h3> +Moves the cursor to the previous widget in the focus chain. There +is <em>always</em> a previous widget because the list is a loop. + +<!-- eof --> +<hr><p> +This file is part of the <a href="index.html">Qt toolkit</a>. +Copyright © 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 © 2007 +<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a> +<td align=right><div align=right>Qt 3.3.8</div> +</table></div></address></body> +</html> |