blob: 4645447fa0039817457e5a35aa74a1280480316a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
|
/****************************************************************************
**
** Implementation of QFocusData class
**
** Created : 980622
**
** Copyright (C) 1992-2008 Trolltech ASA. All rights reserved.
**
** This file is part of the kernel module of the Qt GUI Toolkit.
**
** This file may be used under the terms of the GNU General
** Public License versions 2.0 or 3.0 as published by the Free
** Software Foundation and appearing in the files LICENSE.GPL2
** and LICENSE.GPL3 included in the packaging of this file.
** Alternatively you may (at your option) use any later version
** of the GNU General Public License if such license has been
** publicly approved by Trolltech ASA (or its successors, if any)
** and the KDE Free Qt Foundation.
**
** Please review the following information to ensure GNU General
** Public Licensing requirements will be met:
** http://trolltech.com/products/qt/licenses/licensing/opensource/.
** If you are unsure which license is appropriate for your use, please
** review the following information:
** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
** or contact the sales department at sales@trolltech.com.
**
** This file may be used under the terms of the Q Public License as
** defined by Trolltech ASA and appearing in the file LICENSE.QPL
** included in the packaging of this file. Licensees holding valid Qt
** Commercial licenses may use this file in accordance with the Qt
** Commercial License Agreement provided with the Software.
**
** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
** herein.
**
**********************************************************************/
#include "qfocusdata.h"
/*!
\class QFocusData qfocusdata.h
\brief The QFocusData class maintains the list of widgets in the focus
chain.
\ingroup misc
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 home(), or moved to its
neighboring widgets using next() and prev(). You can also retrieve
the count() 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.
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.
When reimplementing QWidget::focusNextPrevChild() to provide
special focus flow, you will usually call QWidget::focusData() 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.
The cursor may change at any time.
This class is \e not thread-safe.
\sa QWidget::focusNextPrevChild() QWidget::setTabOrder()
QWidget::setFocusPolicy()
*/
/*!
\fn QWidget* QFocusData::focusWidget() const
Returns the widgets in the hierarchy that are in the focus chain.
*/
/*!
\fn int QFocusData::count() const
Returns the number of widgets in the focus chain.
*/
/*!
Moves the cursor to the focusWidget() and returns that widget. You
must call this before next() or prev() to iterate meaningfully.
*/
QWidget* QFocusData::home()
{
focusWidgets.find(it.current());
return focusWidgets.current();
}
/*!
Moves the cursor to the next widget in the focus chain. There is
\e always a next widget because the list is a loop.
*/
QWidget* QFocusData::next()
{
QWidget* r = focusWidgets.next();
if ( !r )
r = focusWidgets.first();
return r;
}
/*!
Moves the cursor to the previous widget in the focus chain. There
is \e always a previous widget because the list is a loop.
*/
QWidget* QFocusData::prev()
{
QWidget* r = focusWidgets.prev();
if ( !r )
r = focusWidgets.last();
return r;
}
/*!
Returns the last widget in the focus chain.
The cursor is not modified.
*/
QWidget *QFocusData::last() const
{
return focusWidgets.getLast();
}
/*!
Returns the first widget in the focus chain.
The cursor is not modified.
*/
QWidget *QFocusData::first() const
{
return focusWidgets.getFirst();
}
|
