Qt 4.8
qaccessibleobject.h
Go to the documentation of this file.
1 /****************************************************************************
2 **
3 ** Copyright (C) 2014 Digia Plc and/or its subsidiary(-ies).
4 ** Contact: http://www.qt-project.org/legal
5 **
6 ** This file is part of the QtGui module of the Qt Toolkit.
7 **
8 ** $QT_BEGIN_LICENSE:LGPL$
9 ** Commercial License Usage
10 ** Licensees holding valid commercial Qt licenses may use this file in
11 ** accordance with the commercial license agreement provided with the
12 ** Software or, alternatively, in accordance with the terms contained in
13 ** a written agreement between you and Digia. For licensing terms and
14 ** conditions see http://qt.digia.com/licensing. For further information
15 ** use the contact form at http://qt.digia.com/contact-us.
16 **
17 ** GNU Lesser General Public License Usage
18 ** Alternatively, this file may be used under the terms of the GNU Lesser
19 ** General Public License version 2.1 as published by the Free Software
20 ** Foundation and appearing in the file LICENSE.LGPL included in the
21 ** packaging of this file. Please review the following information to
22 ** ensure the GNU Lesser General Public License version 2.1 requirements
23 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
24 **
25 ** In addition, as a special exception, Digia gives you certain additional
26 ** rights. These rights are described in the Digia Qt LGPL Exception
27 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
28 **
29 ** GNU General Public License Usage
30 ** Alternatively, this file may be used under the terms of the GNU
31 ** General Public License version 3.0 as published by the Free Software
32 ** Foundation and appearing in the file LICENSE.GPL included in the
33 ** packaging of this file. Please review the following information to
34 ** ensure the GNU General Public License version 3.0 requirements will be
35 ** met: http://www.gnu.org/copyleft/gpl.html.
36 **
37 **
38 ** $QT_END_LICENSE$
39 **
40 ****************************************************************************/
41 
42 #ifndef QACCESSIBLEOBJECT_H
43 #define QACCESSIBLEOBJECT_H
44 
45 #include <QtGui/qaccessible.h>
46 
48 
50 
51 QT_MODULE(Gui)
52 
53 #ifndef QT_NO_ACCESSIBILITY
54 
56 class QObject;
57 
59 {
60 public:
61  explicit QAccessibleObject(QObject *object);
62 
63  bool isValid() const;
64  QObject *object() const;
65 
66  // properties
67  QRect rect(int child) const;
68  void setText(Text t, int child, const QString &text);
69 
70  // actions
71  int userActionCount(int child) const;
72  bool doAction(int action, int child, const QVariantList &params);
73  QString actionText(int action, Text t, int child) const;
74 
75 protected:
76  virtual ~QAccessibleObject();
77 
78 private:
79  friend class QAccessibleObjectEx;
82 };
83 
85 {
86 public:
87  explicit QAccessibleObjectEx(QObject *object);
88 
89  bool isValid() const;
90  QObject *object() const;
91 
92  // properties
93  QRect rect(int child) const;
94  void setText(Text t, int child, const QString &text);
95 
96  // actions
97  int userActionCount(int child) const;
98  bool doAction(int action, int child, const QVariantList &params);
99  QString actionText(int action, Text t, int child) const;
100 
101 protected:
102  virtual ~QAccessibleObjectEx();
103 
104 private:
107 };
108 
110 {
111 public:
113 
114  // relations
115  int childCount() const;
116  int indexOfChild(const QAccessibleInterface*) const;
117  Relation relationTo(int, const QAccessibleInterface *, int) const;
118 
119  // navigation
120  int childAt(int x, int y) const;
121  int navigate(RelationFlag, int, QAccessibleInterface **) const;
122 
123  // properties and state
124  QString text(Text t, int child) const;
125  Role role(int child) const;
126  State state(int child) const;
127 
128  // actions
129  int userActionCount(int child) const;
130  bool doAction(int action, int child, const QVariantList &params);
131  QString actionText(int action, Text t, int child) const;
132 };
133 
134 #endif // QT_NO_ACCESSIBILITY
135 
137 
139 
140 #endif // QACCESSIBLEOBJECT_H
virtual int indexOfChild(const QAccessibleInterface *) const =0
Returns the 1-based index of the object child in this object&#39;s children list, or -1 if child is not a...
#define QT_END_NAMESPACE
This macro expands to.
Definition: qglobal.h:90
The QAccessibleApplication class implements the QAccessibleInterface for QApplication.
#define QT_MODULE(x)
Definition: qglobal.h:2783
#define QT_BEGIN_HEADER
Definition: qglobal.h:136
virtual State state(int child) const =0
Returns the current state of the object, or of the object&#39;s child if child is not 0...
#define Q_GUI_EXPORT
Definition: qglobal.h:1450
Role
This enum defines the role of an accessible object.
Definition: qaccessible.h:188
virtual int childCount() const =0
Returns the number of children that belong to this object.
#define Q_DISABLE_COPY(Class)
Disables the use of copy constructors and assignment operators for the given Class.
Definition: qglobal.h:2523
The QString class provides a Unicode character string.
Definition: qstring.h:83
virtual QObject * object() const =0
Returns a pointer to the QObject this interface implementation provides information for...
The QObject class is the base class of all Qt objects.
Definition: qobject.h:111
bool doAction(int action, int child, const QVariantList &params)
Reimplemented Function
virtual int childAt(int x, int y) const =0
Returns the 1-based index of the child that contains the screen coordinates (x, y).
#define QT_BEGIN_NAMESPACE
This macro expands to.
Definition: qglobal.h:89
virtual int navigate(RelationFlag relation, int index, QAccessibleInterface **iface) const =0
Navigates from this object to an object that has a relationship relation to this object, and returns the respective object in target.
RelationFlag
This enum type defines bit flags that can be combined to indicate the relationship between two access...
Definition: qaccessible.h:268
int userActionCount(int child) const
Reimplemented Function
The State element defines configurations of objects and properties.
QString actionText(int action, Text t, int child) const
Reimplemented Function
QAccessibleObjectPrivate * d
virtual Role role(int child) const =0
Returns the role of the object, or of the object&#39;s child if child is not 0.
virtual QString actionText(int action, Text t, int child) const =0
Returns the text property t of the action action supported by the object, or of the object&#39;s child if...
virtual Relation relationTo(int child, const QAccessibleInterface *other, int otherChild) const =0
Returns the relationship between this object&#39;s \a child and the \a other object&#39;s \a otherChild...
virtual bool doAction(int action, int child, const QVariantList &params=QVariantList())=0
Asks the object, or the object&#39;s child if child is not 0, to execute action using the parameters...
virtual int userActionCount(int child) const =0
Returns the number of custom actions of the object, or of the object&#39;s child if child is not 0...
virtual bool isValid() const =0
Returns true if all the data necessary to use this interface implementation is valid (e...
The QAccessibleInterface class defines an interface that exposes information about accessible objects...
Definition: qaccessible.h:370
virtual QString text(Text t, int child) const =0
Returns the value of the text property t of the object, or of the object&#39;s child if child is not 0...
The QRect class defines a rectangle in the plane using integer precision.
Definition: qrect.h:58
The QAccessibleObject class implements parts of the QAccessibleInterface for QObjects.
virtual QRect rect(int child) const =0
Returns the geometry of the object, or of the object&#39;s child if child is not 0.
QAccessibleObjectPrivate * d
#define QT_END_HEADER
Definition: qglobal.h:137
virtual void setText(Text t, int child, const QString &text)=0
Sets the text property t of the object, or of the object&#39;s child if child is not 0, to text.
#define text
Definition: qobjectdefs.h:80
The Text item allows you to add formatted text to a scene.