| Line | Source Code | Coverage |
|---|
| 1 | /**************************************************************************** | - |
| 2 | ** | - |
| 3 | ** Copyright (C) 2013 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 | #include "qshortcut.h" | - |
| 43 | #include "private/qwidget_p.h" | - |
| 44 | | - |
| 45 | #ifndef QT_NO_SHORTCUT | - |
| 46 | #include <qevent.h> | - |
| 47 | #include <qwhatsthis.h> | - |
| 48 | #include <qmenu.h> | - |
| 49 | #include <qmenubar.h> | - |
| 50 | #include <qapplication.h> | - |
| 51 | #include <private/qapplication_p.h> | - |
| 52 | #include <private/qshortcutmap_p.h> | - |
| 53 | #include <private/qaction_p.h> | - |
| 54 | | - |
| 55 | QT_BEGIN_NAMESPACE | - |
| 56 | | - |
| 57 | #define QAPP_CHECK(functionName) \ | - |
| 58 | if (!qApp) { \ | - |
| 59 | qWarning("QShortcut: Initialize QApplication before calling '" functionName "'."); \ | - |
| 60 | return; \ | - |
| 61 | } | - |
| 62 | | - |
| 63 | | - |
| 64 | static bool correctWidgetContext(Qt::ShortcutContext context, QWidget *w, QWidget *active_window); | - |
| 65 | #ifndef QT_NO_GRAPHICSVIEW | - |
| 66 | static bool correctGraphicsWidgetContext(Qt::ShortcutContext context, QGraphicsWidget *w, QWidget *active_window); | - |
| 67 | #endif | - |
| 68 | #ifndef QT_NO_ACTION | - |
| 69 | static bool correctActionContext(Qt::ShortcutContext context, QAction *a, QWidget *active_window); | - |
| 70 | #endif | - |
| 71 | | - |
| 72 | | - |
| 73 | /*! \internal | - |
| 74 | Returns true if the widget \a w is a logical sub window of the current | - |
| 75 | top-level widget. | - |
| 76 | */ | - |
| 77 | bool qWidgetShortcutContextMatcher(QObject *object, Qt::ShortcutContext context) | - |
| 78 | { | - |
| 79 | Q_ASSERT_X(object, "QShortcutMap", "Shortcut has no owner. Illegal map state!"); executed (the execution status of this line is deduced): qt_noop(); | - |
| 80 | | - |
| 81 | QWidget *active_window = QApplication::activeWindow(); executed (the execution status of this line is deduced): QWidget *active_window = QApplication::activeWindow(); | - |
| 82 | | - |
| 83 | // popups do not become the active window, | - |
| 84 | // so we fake it here to get the correct context | - |
| 85 | // for the shortcut system. | - |
| 86 | if (QApplication::activePopupWidget()) partially evaluated: QApplication::activePopupWidget()| no Evaluation Count:0 | yes Evaluation Count:219 |
| 0-219 |
| 87 | active_window = QApplication::activePopupWidget(); never executed: active_window = QApplication::activePopupWidget(); | 0 |
| 88 | | - |
| 89 | if (!active_window) partially evaluated: !active_window| no Evaluation Count:0 | yes Evaluation Count:219 |
| 0-219 |
| 90 | return false; never executed: return false; | 0 |
| 91 | | - |
| 92 | #ifndef QT_NO_ACTION | - |
| 93 | if (QAction *a = qobject_cast<QAction *>(object)) evaluated: QAction *a = qobject_cast<QAction *>(object)| yes Evaluation Count:16 | yes Evaluation Count:203 |
| 16-203 |
| 94 | return correctActionContext(context, a, active_window); executed: return correctActionContext(context, a, active_window);Execution Count:16 | 16 |
| 95 | #endif | - |
| 96 | | - |
| 97 | #ifndef QT_NO_GRAPHICSVIEW | - |
| 98 | if (QGraphicsWidget *gw = qobject_cast<QGraphicsWidget *>(object)) partially evaluated: QGraphicsWidget *gw = qobject_cast<QGraphicsWidget *>(object)| no Evaluation Count:0 | yes Evaluation Count:203 |
| 0-203 |
| 99 | return correctGraphicsWidgetContext(context, gw, active_window); never executed: return correctGraphicsWidgetContext(context, gw, active_window); | 0 |
| 100 | #endif | - |
| 101 | | - |
| 102 | QWidget *w = qobject_cast<QWidget *>(object); executed (the execution status of this line is deduced): QWidget *w = qobject_cast<QWidget *>(object); | - |
| 103 | if (!w) { evaluated: !w| yes Evaluation Count:178 | yes Evaluation Count:25 |
| 25-178 |
| 104 | QShortcut *s = qobject_cast<QShortcut *>(object); executed (the execution status of this line is deduced): QShortcut *s = qobject_cast<QShortcut *>(object); | - |
| 105 | if (s) partially evaluated: s| yes Evaluation Count:178 | no Evaluation Count:0 |
| 0-178 |
| 106 | w = s->parentWidget(); executed: w = s->parentWidget();Execution Count:178 | 178 |
| 107 | } executed: }Execution Count:178 | 178 |
| 108 | | - |
| 109 | if (!w) partially evaluated: !w| no Evaluation Count:0 | yes Evaluation Count:203 |
| 0-203 |
| 110 | return false; never executed: return false; | 0 |
| 111 | | - |
| 112 | return correctWidgetContext(context, w, active_window); executed: return correctWidgetContext(context, w, active_window);Execution Count:203 | 203 |
| 113 | } | - |
| 114 | | - |
| 115 | static bool correctWidgetContext(Qt::ShortcutContext context, QWidget *w, QWidget *active_window) | - |
| 116 | { | - |
| 117 | bool visible = w->isVisible(); executed (the execution status of this line is deduced): bool visible = w->isVisible(); | - |
| 118 | #ifdef Q_OS_MAC | - |
| 119 | if (!qApp->testAttribute(Qt::AA_DontUseNativeMenuBar) && qobject_cast<QMenuBar *>(w)) | - |
| 120 | visible = true; | - |
| 121 | #endif | - |
| 122 | | - |
| 123 | if (!visible || !w->isEnabled()) partially evaluated: !visible| no Evaluation Count:0 | yes Evaluation Count:218 |
partially evaluated: !w->isEnabled()| no Evaluation Count:0 | yes Evaluation Count:218 |
| 0-218 |
| 124 | return false; never executed: return false; | 0 |
| 125 | | - |
| 126 | if (context == Qt::ApplicationShortcut) evaluated: context == Qt::ApplicationShortcut| yes Evaluation Count:1 | yes Evaluation Count:217 |
| 1-217 |
| 127 | return QApplicationPrivate::tryModalHelper(w, 0); // true, unless w is shadowed by a modal dialog executed: return QApplicationPrivate::tryModalHelper(w, 0);Execution Count:1 | 1 |
| 128 | | - |
| 129 | if (context == Qt::WidgetShortcut) evaluated: context == Qt::WidgetShortcut| yes Evaluation Count:2 | yes Evaluation Count:215 |
| 2-215 |
| 130 | return w == QApplication::focusWidget(); executed: return w == QApplication::focusWidget();Execution Count:2 | 2 |
| 131 | | - |
| 132 | if (context == Qt::WidgetWithChildrenShortcut) { partially evaluated: context == Qt::WidgetWithChildrenShortcut| no Evaluation Count:0 | yes Evaluation Count:215 |
| 0-215 |
| 133 | const QWidget *tw = QApplication::focusWidget(); never executed (the execution status of this line is deduced): const QWidget *tw = QApplication::focusWidget(); | - |
| 134 | while (tw && tw != w && (tw->windowType() == Qt::Widget || tw->windowType() == Qt::Popup)) never evaluated: tw never evaluated: tw != w never evaluated: tw->windowType() == Qt::Widget never evaluated: tw->windowType() == Qt::Popup | 0 |
| 135 | tw = tw->parentWidget(); never executed: tw = tw->parentWidget(); | 0 |
| 136 | return tw == w; never executed: return tw == w; | 0 |
| 137 | } | - |
| 138 | | - |
| 139 | // Below is Qt::WindowShortcut context | - |
| 140 | QWidget *tlw = w->window(); executed (the execution status of this line is deduced): QWidget *tlw = w->window(); | - |
| 141 | #ifndef QT_NO_GRAPHICSVIEW | - |
| 142 | if (QWExtra *topData = static_cast<QWidgetPrivate *>(QObjectPrivate::get(tlw))->extra) { partially evaluated: QWExtra *topData = static_cast<QWidgetPrivate *>(QObjectPrivate::get(tlw))->extra| yes Evaluation Count:215 | no Evaluation Count:0 |
| 0-215 |
| 143 | if (topData->proxyWidget) { partially evaluated: topData->proxyWidget| no Evaluation Count:0 | yes Evaluation Count:215 |
| 0-215 |
| 144 | bool res = correctGraphicsWidgetContext(context, (QGraphicsWidget *)topData->proxyWidget, active_window); never executed (the execution status of this line is deduced): bool res = correctGraphicsWidgetContext(context, (QGraphicsWidget *)topData->proxyWidget, active_window); | - |
| 145 | return res; never executed: return res; | 0 |
| 146 | } | - |
| 147 | } executed: }Execution Count:215 | 215 |
| 148 | #endif | - |
| 149 | | - |
| 150 | /* if a floating tool window is active, keep shortcuts on the | - |
| 151 | * parent working */ | - |
| 152 | if (active_window != tlw && active_window && active_window->windowType() == Qt::Tool && active_window->parentWidget()) { partially evaluated: active_window != tlw| no Evaluation Count:0 | yes Evaluation Count:215 |
never evaluated: active_window never evaluated: active_window->windowType() == Qt::Tool never evaluated: active_window->parentWidget() | 0-215 |
| 153 | active_window = active_window->parentWidget()->window(); never executed (the execution status of this line is deduced): active_window = active_window->parentWidget()->window(); | - |
| 154 | } | 0 |
| 155 | | - |
| 156 | if (active_window != tlw) partially evaluated: active_window != tlw| no Evaluation Count:0 | yes Evaluation Count:215 |
| 0-215 |
| 157 | return false; never executed: return false; | 0 |
| 158 | | - |
| 159 | /* if we live in a MDI subwindow, ignore the event if we are | - |
| 160 | not the active document window */ | - |
| 161 | const QWidget* sw = w; executed (the execution status of this line is deduced): const QWidget* sw = w; | - |
| 162 | while (sw && !(sw->windowType() == Qt::SubWindow) && !sw->isWindow()) partially evaluated: sw| yes Evaluation Count:270 | no Evaluation Count:0 |
partially evaluated: !(sw->windowType() == Qt::SubWindow)| yes Evaluation Count:270 | no Evaluation Count:0 |
evaluated: !sw->isWindow()| yes Evaluation Count:55 | yes Evaluation Count:215 |
| 0-270 |
| 163 | sw = sw->parentWidget(); executed: sw = sw->parentWidget();Execution Count:55 | 55 |
| 164 | if (sw && (sw->windowType() == Qt::SubWindow)) { partially evaluated: sw| yes Evaluation Count:215 | no Evaluation Count:0 |
partially evaluated: (sw->windowType() == Qt::SubWindow)| no Evaluation Count:0 | yes Evaluation Count:215 |
| 0-215 |
| 165 | QWidget *focus_widget = QApplication::focusWidget(); never executed (the execution status of this line is deduced): QWidget *focus_widget = QApplication::focusWidget(); | - |
| 166 | while (focus_widget && focus_widget != sw) never evaluated: focus_widget never evaluated: focus_widget != sw | 0 |
| 167 | focus_widget = focus_widget->parentWidget(); never executed: focus_widget = focus_widget->parentWidget(); | 0 |
| 168 | return sw == focus_widget; never executed: return sw == focus_widget; | 0 |
| 169 | } | - |
| 170 | | - |
| 171 | #if defined(DEBUG_QSHORTCUTMAP) | - |
| 172 | qDebug().nospace() << "..true [Pass-through]"; | - |
| 173 | #endif | - |
| 174 | return true; executed: return true;Execution Count:215 | 215 |
| 175 | } | - |
| 176 | | - |
| 177 | #ifndef QT_NO_GRAPHICSVIEW | - |
| 178 | static bool correctGraphicsWidgetContext(Qt::ShortcutContext context, QGraphicsWidget *w, QWidget *active_window) | - |
| 179 | { | - |
| 180 | bool visible = w->isVisible(); never executed (the execution status of this line is deduced): bool visible = w->isVisible(); | - |
| 181 | #ifdef Q_OS_MAC | - |
| 182 | if (!qApp->testAttribute(Qt::AA_DontUseNativeMenuBar) && qobject_cast<QMenuBar *>(w)) | - |
| 183 | visible = true; | - |
| 184 | #endif | - |
| 185 | | - |
| 186 | if (!visible || !w->isEnabled() || !w->scene()) never evaluated: !visible never evaluated: !w->isEnabled() never evaluated: !w->scene() | 0 |
| 187 | return false; never executed: return false; | 0 |
| 188 | | - |
| 189 | if (context == Qt::ApplicationShortcut) { never evaluated: context == Qt::ApplicationShortcut | 0 |
| 190 | // Applicationwide shortcuts are always reachable unless their owner | - |
| 191 | // is shadowed by modality. In QGV there's no modality concept, but we | - |
| 192 | // must still check if all views are shadowed. | - |
| 193 | QList<QGraphicsView *> views = w->scene()->views(); never executed (the execution status of this line is deduced): QList<QGraphicsView *> views = w->scene()->views(); | - |
| 194 | for (int i = 0; i < views.size(); ++i) { never evaluated: i < views.size() | 0 |
| 195 | if (QApplicationPrivate::tryModalHelper(views.at(i), 0)) never evaluated: QApplicationPrivate::tryModalHelper(views.at(i), 0) | 0 |
| 196 | return true; never executed: return true; | 0 |
| 197 | } | 0 |
| 198 | return false; never executed: return false; | 0 |
| 199 | } | - |
| 200 | | - |
| 201 | if (context == Qt::WidgetShortcut) never evaluated: context == Qt::WidgetShortcut | 0 |
| 202 | return static_cast<QGraphicsItem *>(w) == w->scene()->focusItem(); never executed: return static_cast<QGraphicsItem *>(w) == w->scene()->focusItem(); | 0 |
| 203 | | - |
| 204 | if (context == Qt::WidgetWithChildrenShortcut) { never evaluated: context == Qt::WidgetWithChildrenShortcut | 0 |
| 205 | const QGraphicsItem *ti = w->scene()->focusItem(); never executed (the execution status of this line is deduced): const QGraphicsItem *ti = w->scene()->focusItem(); | - |
| 206 | if (ti && ti->isWidget()) { never evaluated: ti never evaluated: ti->isWidget() | 0 |
| 207 | const QGraphicsWidget *tw = static_cast<const QGraphicsWidget *>(ti); never executed (the execution status of this line is deduced): const QGraphicsWidget *tw = static_cast<const QGraphicsWidget *>(ti); | - |
| 208 | while (tw && tw != w && (tw->windowType() == Qt::Widget || tw->windowType() == Qt::Popup)) never evaluated: tw never evaluated: tw != w never evaluated: tw->windowType() == Qt::Widget never evaluated: tw->windowType() == Qt::Popup | 0 |
| 209 | tw = tw->parentWidget(); never executed: tw = tw->parentWidget(); | 0 |
| 210 | return tw == w; never executed: return tw == w; | 0 |
| 211 | } | - |
| 212 | return false; never executed: return false; | 0 |
| 213 | } | - |
| 214 | | - |
| 215 | // Below is Qt::WindowShortcut context | - |
| 216 | | - |
| 217 | // Find the active view (if any). | - |
| 218 | QList<QGraphicsView *> views = w->scene()->views(); never executed (the execution status of this line is deduced): QList<QGraphicsView *> views = w->scene()->views(); | - |
| 219 | QGraphicsView *activeView = 0; never executed (the execution status of this line is deduced): QGraphicsView *activeView = 0; | - |
| 220 | for (int i = 0; i < views.size(); ++i) { never evaluated: i < views.size() | 0 |
| 221 | QGraphicsView *view = views.at(i); never executed (the execution status of this line is deduced): QGraphicsView *view = views.at(i); | - |
| 222 | if (view->window() == active_window) { never evaluated: view->window() == active_window | 0 |
| 223 | activeView = view; never executed (the execution status of this line is deduced): activeView = view; | - |
| 224 | break; | 0 |
| 225 | } | - |
| 226 | } | 0 |
| 227 | if (!activeView) never evaluated: !activeView | 0 |
| 228 | return false; never executed: return false; | 0 |
| 229 | | - |
| 230 | // The shortcut is reachable if owned by a windowless widget, or if the | - |
| 231 | // widget's window is the same as the focus item's window. | - |
| 232 | QGraphicsWidget *a = w->scene()->activeWindow(); never executed (the execution status of this line is deduced): QGraphicsWidget *a = w->scene()->activeWindow(); | - |
| 233 | return !w->window() || a == w->window(); never executed: return !w->window() || a == w->window(); | 0 |
| 234 | } | - |
| 235 | #endif | - |
| 236 | | - |
| 237 | #ifndef QT_NO_ACTION | - |
| 238 | static bool correctActionContext(Qt::ShortcutContext context, QAction *a, QWidget *active_window) | - |
| 239 | { | - |
| 240 | const QList<QWidget *> &widgets = static_cast<QActionPrivate *>(QObjectPrivate::get(a))->widgets; executed (the execution status of this line is deduced): const QList<QWidget *> &widgets = static_cast<QActionPrivate *>(QObjectPrivate::get(a))->widgets; | - |
| 241 | #if defined(DEBUG_QSHORTCUTMAP) | - |
| 242 | if (widgets.isEmpty()) | - |
| 243 | qDebug() << a << "not connected to any widgets; won't trigger"; | - |
| 244 | #endif | - |
| 245 | for (int i = 0; i < widgets.size(); ++i) { evaluated: i < widgets.size()| yes Evaluation Count:23 | yes Evaluation Count:1 |
| 1-23 |
| 246 | QWidget *w = widgets.at(i); executed (the execution status of this line is deduced): QWidget *w = widgets.at(i); | - |
| 247 | #ifndef QT_NO_MENU | - |
| 248 | if (QMenu *menu = qobject_cast<QMenu *>(w)) { evaluated: QMenu *menu = qobject_cast<QMenu *>(w)| yes Evaluation Count:8 | yes Evaluation Count:15 |
| 8-15 |
| 249 | QAction *a = menu->menuAction(); executed (the execution status of this line is deduced): QAction *a = menu->menuAction(); | - |
| 250 | if (correctActionContext(context, a, active_window)) partially evaluated: correctActionContext(context, a, active_window)| yes Evaluation Count:8 | no Evaluation Count:0 |
| 0-8 |
| 251 | return true; executed: return true;Execution Count:8 | 8 |
| 252 | } else | 0 |
| 253 | #endif | - |
| 254 | if (correctWidgetContext(context, w, active_window)) partially evaluated: correctWidgetContext(context, w, active_window)| yes Evaluation Count:15 | no Evaluation Count:0 |
| 0-15 |
| 255 | return true; executed: return true;Execution Count:15 | 15 |
| 256 | } | - |
| 257 | | - |
| 258 | #ifndef QT_NO_GRAPHICSVIEW | - |
| 259 | const QList<QGraphicsWidget *> &graphicsWidgets = static_cast<QActionPrivate *>(QObjectPrivate::get(a))->graphicsWidgets; executed (the execution status of this line is deduced): const QList<QGraphicsWidget *> &graphicsWidgets = static_cast<QActionPrivate *>(QObjectPrivate::get(a))->graphicsWidgets; | - |
| 260 | #if defined(DEBUG_QSHORTCUTMAP) | - |
| 261 | if (graphicsWidgets.isEmpty()) | - |
| 262 | qDebug() << a << "not connected to any widgets; won't trigger"; | - |
| 263 | #endif | - |
| 264 | for (int i = 0; i < graphicsWidgets.size(); ++i) { partially evaluated: i < graphicsWidgets.size()| no Evaluation Count:0 | yes Evaluation Count:1 |
| 0-1 |
| 265 | QGraphicsWidget *w = graphicsWidgets.at(i); never executed (the execution status of this line is deduced): QGraphicsWidget *w = graphicsWidgets.at(i); | - |
| 266 | if (correctGraphicsWidgetContext(context, w, active_window)) never evaluated: correctGraphicsWidgetContext(context, w, active_window) | 0 |
| 267 | return true; never executed: return true; | 0 |
| 268 | } | 0 |
| 269 | #endif | - |
| 270 | return false; executed: return false;Execution Count:1 | 1 |
| 271 | } | - |
| 272 | #endif // QT_NO_ACTION | - |
| 273 | | - |
| 274 | | - |
| 275 | /*! | - |
| 276 | \class QShortcut | - |
| 277 | \brief The QShortcut class is used to create keyboard shortcuts. | - |
| 278 | | - |
| 279 | \ingroup events | - |
| 280 | \inmodule QtWidgets | - |
| 281 | | - |
| 282 | The QShortcut class provides a way of connecting keyboard | - |
| 283 | shortcuts to Qt's \l{signals and slots} mechanism, so that | - |
| 284 | objects can be informed when a shortcut is executed. The shortcut | - |
| 285 | can be set up to contain all the key presses necessary to | - |
| 286 | describe a keyboard shortcut, including the states of modifier | - |
| 287 | keys such as \uicontrol Shift, \uicontrol Ctrl, and \uicontrol Alt. | - |
| 288 | | - |
| 289 | \target mnemonic | - |
| 290 | | - |
| 291 | On certain widgets, using '&' in front of a character will | - |
| 292 | automatically create a mnemonic (a shortcut) for that character, | - |
| 293 | e.g. "E&xit" will create the shortcut \uicontrol Alt+X (use '&&' to | - |
| 294 | display an actual ampersand). The widget might consume and perform | - |
| 295 | an action on a given shortcut. On X11 the ampersand will not be | - |
| 296 | shown and the character will be underlined. On Windows, shortcuts | - |
| 297 | are normally not displayed until the user presses the \uicontrol Alt | - |
| 298 | key, but this is a setting the user can change. On Mac, shortcuts | - |
| 299 | are disabled by default. Call qt_set_sequence_auto_mnemonic() to | - |
| 300 | enable them. However, because mnemonic shortcuts do not fit in | - |
| 301 | with Aqua's guidelines, Qt will not show the shortcut character | - |
| 302 | underlined. | - |
| 303 | | - |
| 304 | For applications that use menus, it may be more convenient to | - |
| 305 | use the convenience functions provided in the QMenu class to | - |
| 306 | assign keyboard shortcuts to menu items as they are created. | - |
| 307 | Alternatively, shortcuts may be associated with other types of | - |
| 308 | actions in the QAction class. | - |
| 309 | | - |
| 310 | The simplest way to create a shortcut for a particular widget is | - |
| 311 | to construct the shortcut with a key sequence. For example: | - |
| 312 | | - |
| 313 | \snippet code/src_gui_kernel_qshortcut.cpp 0 | - |
| 314 | | - |
| 315 | When the user types the \l{QKeySequence}{key sequence} | - |
| 316 | for a given shortcut, the shortcut's activated() signal is | - |
| 317 | emitted. (In the case of ambiguity, the activatedAmbiguously() | - |
| 318 | signal is emitted.) A shortcut is "listened for" by Qt's event | - |
| 319 | loop when the shortcut's parent widget is receiving events. | - |
| 320 | | - |
| 321 | A shortcut's key sequence can be set with setKey() and retrieved | - |
| 322 | with key(). A shortcut can be enabled or disabled with | - |
| 323 | setEnabled(), and can have "What's This?" help text set with | - |
| 324 | setWhatsThis(). | - |
| 325 | | - |
| 326 | \sa QShortcutEvent, QKeySequence, QAction | - |
| 327 | */ | - |
| 328 | | - |
| 329 | /*! | - |
| 330 | \fn QWidget *QShortcut::parentWidget() const | - |
| 331 | | - |
| 332 | Returns the shortcut's parent widget. | - |
| 333 | */ | - |
| 334 | | - |
| 335 | /*! | - |
| 336 | \fn void QShortcut::activated() | - |
| 337 | | - |
| 338 | This signal is emitted when the user types the shortcut's key | - |
| 339 | sequence. | - |
| 340 | | - |
| 341 | \sa activatedAmbiguously() | - |
| 342 | */ | - |
| 343 | | - |
| 344 | /*! | - |
| 345 | \fn void QShortcut::activatedAmbiguously() | - |
| 346 | | - |
| 347 | When a key sequence is being typed at the keyboard, it is said to | - |
| 348 | be ambiguous as long as it matches the start of more than one | - |
| 349 | shortcut. | - |
| 350 | | - |
| 351 | When a shortcut's key sequence is completed, | - |
| 352 | activatedAmbiguously() is emitted if the key sequence is still | - |
| 353 | ambiguous (i.e., it is the start of one or more other shortcuts). | - |
| 354 | The activated() signal is not emitted in this case. | - |
| 355 | | - |
| 356 | \sa activated() | - |
| 357 | */ | - |
| 358 | | - |
| 359 | /* | - |
| 360 | \internal | - |
| 361 | Private data accessed through d-pointer. | - |
| 362 | */ | - |
| 363 | class QShortcutPrivate : public QObjectPrivate | - |
| 364 | { | - |
| 365 | Q_DECLARE_PUBLIC(QShortcut) | - |
| 366 | public: | - |
| 367 | QShortcutPrivate() : sc_context(Qt::WindowShortcut), sc_enabled(true), sc_autorepeat(true), sc_id(0) {} executed: }Execution Count:447 | 447 |
| 368 | QKeySequence sc_sequence; | - |
| 369 | Qt::ShortcutContext sc_context; | - |
| 370 | bool sc_enabled; | - |
| 371 | bool sc_autorepeat; | - |
| 372 | int sc_id; | - |
| 373 | QString sc_whatsthis; | - |
| 374 | void redoGrab(QShortcutMap &map); | - |
| 375 | }; | - |
| 376 | | - |
| 377 | void QShortcutPrivate::redoGrab(QShortcutMap &map) | - |
| 378 | { | - |
| 379 | Q_Q(QShortcut); executed (the execution status of this line is deduced): QShortcut * const q = q_func(); | - |
| 380 | if (!parent) { partially evaluated: !parent| no Evaluation Count:0 | yes Evaluation Count:512 |
| 0-512 |
| 381 | qWarning("QShortcut: No widget parent defined"); never executed (the execution status of this line is deduced): QMessageLogger("kernel/qshortcut.cpp", 381, __PRETTY_FUNCTION__).warning("QShortcut: No widget parent defined"); | - |
| 382 | return; | 0 |
| 383 | } | - |
| 384 | | - |
| 385 | if (sc_id) partially evaluated: sc_id| no Evaluation Count:0 | yes Evaluation Count:512 |
| 0-512 |
| 386 | map.removeShortcut(sc_id, q); never executed: map.removeShortcut(sc_id, q); | 0 |
| 387 | if (sc_sequence.isEmpty()) evaluated: sc_sequence.isEmpty()| yes Evaluation Count:65 | yes Evaluation Count:447 |
| 65-447 |
| 388 | return; executed: return;Execution Count:65 | 65 |
| 389 | sc_id = map.addShortcut(q, sc_sequence, sc_context, qWidgetShortcutContextMatcher); executed (the execution status of this line is deduced): sc_id = map.addShortcut(q, sc_sequence, sc_context, qWidgetShortcutContextMatcher); | - |
| 390 | if (!sc_enabled) partially evaluated: !sc_enabled| no Evaluation Count:0 | yes Evaluation Count:447 |
| 0-447 |
| 391 | map.setShortcutEnabled(false, sc_id, q); never executed: map.setShortcutEnabled(false, sc_id, q); | 0 |
| 392 | if (!sc_autorepeat) partially evaluated: !sc_autorepeat| no Evaluation Count:0 | yes Evaluation Count:447 |
| 0-447 |
| 393 | map.setShortcutAutoRepeat(false, sc_id, q); never executed: map.setShortcutAutoRepeat(false, sc_id, q); | 0 |
| 394 | } executed: }Execution Count:447 | 447 |
| 395 | | - |
| 396 | /*! | - |
| 397 | Constructs a QShortcut object for the \a parent widget. Since no | - |
| 398 | shortcut key sequence is specified, the shortcut will not emit any | - |
| 399 | signals. | - |
| 400 | | - |
| 401 | \sa setKey() | - |
| 402 | */ | - |
| 403 | QShortcut::QShortcut(QWidget *parent) | - |
| 404 | : QObject(*new QShortcutPrivate, parent) | - |
| 405 | { | - |
| 406 | Q_ASSERT(parent != 0); executed (the execution status of this line is deduced): qt_noop(); | - |
| 407 | } executed: }Execution Count:378 | 378 |
| 408 | | - |
| 409 | /*! | - |
| 410 | Constructs a QShortcut object for the \a parent widget. The shortcut | - |
| 411 | operates on its parent, listening for \l{QShortcutEvent}s that | - |
| 412 | match the \a key sequence. Depending on the ambiguity of the | - |
| 413 | event, the shortcut will call the \a member function, or the \a | - |
| 414 | ambiguousMember function, if the key press was in the shortcut's | - |
| 415 | \a context. | - |
| 416 | */ | - |
| 417 | QShortcut::QShortcut(const QKeySequence &key, QWidget *parent, | - |
| 418 | const char *member, const char *ambiguousMember, | - |
| 419 | Qt::ShortcutContext context) | - |
| 420 | : QObject(*new QShortcutPrivate, parent) | - |
| 421 | { | - |
| 422 | QAPP_CHECK("QShortcut"); never executed: return; partially evaluated: !(static_cast<QApplication *>(QCoreApplication::instance()))| no Evaluation Count:0 | yes Evaluation Count:69 |
| 0-69 |
| 423 | | - |
| 424 | Q_D(QShortcut); executed (the execution status of this line is deduced): QShortcutPrivate * const d = d_func(); | - |
| 425 | Q_ASSERT(parent != 0); executed (the execution status of this line is deduced): qt_noop(); | - |
| 426 | d->sc_context = context; executed (the execution status of this line is deduced): d->sc_context = context; | - |
| 427 | d->sc_sequence = key; executed (the execution status of this line is deduced): d->sc_sequence = key; | - |
| 428 | d->redoGrab(qApp->d_func()->shortcutMap); executed (the execution status of this line is deduced): d->redoGrab((static_cast<QApplication *>(QCoreApplication::instance()))->d_func()->shortcutMap); | - |
| 429 | if (member) evaluated: member| yes Evaluation Count:4 | yes Evaluation Count:65 |
| 4-65 |
| 430 | connect(this, SIGNAL(activated()), parent, member); executed: connect(this, "2""activated()", parent, member);Execution Count:4 | 4 |
| 431 | if (ambiguousMember) partially evaluated: ambiguousMember| no Evaluation Count:0 | yes Evaluation Count:69 |
| 0-69 |
| 432 | connect(this, SIGNAL(activatedAmbiguously()), parent, ambiguousMember); never executed: connect(this, "2""activatedAmbiguously()", parent, ambiguousMember); | 0 |
| 433 | } executed: }Execution Count:69 | 69 |
| 434 | | - |
| 435 | /*! | - |
| 436 | Destroys the shortcut. | - |
| 437 | */ | - |
| 438 | QShortcut::~QShortcut() | - |
| 439 | { | - |
| 440 | Q_D(QShortcut); executed (the execution status of this line is deduced): QShortcutPrivate * const d = d_func(); | - |
| 441 | if (qApp) partially evaluated: (static_cast<QApplication *>(QCoreApplication::instance()))| yes Evaluation Count:447 | no Evaluation Count:0 |
| 0-447 |
| 442 | qApp->d_func()->shortcutMap.removeShortcut(d->sc_id, this); executed: (static_cast<QApplication *>(QCoreApplication::instance()))->d_func()->shortcutMap.removeShortcut(d->sc_id, this);Execution Count:447 | 447 |
| 443 | } executed: }Execution Count:447 | 447 |
| 444 | | - |
| 445 | /*! | - |
| 446 | \property QShortcut::key | - |
| 447 | \brief the shortcut's key sequence | - |
| 448 | | - |
| 449 | This is a key sequence with an optional combination of Shift, Ctrl, | - |
| 450 | and Alt. The key sequence may be supplied in a number of ways: | - |
| 451 | | - |
| 452 | \snippet code/src_gui_kernel_qshortcut.cpp 1 | - |
| 453 | | - |
| 454 | By default, this property contains an empty key sequence. | - |
| 455 | */ | - |
| 456 | void QShortcut::setKey(const QKeySequence &key) | - |
| 457 | { | - |
| 458 | Q_D(QShortcut); executed (the execution status of this line is deduced): QShortcutPrivate * const d = d_func(); | - |
| 459 | if (d->sc_sequence == key) evaluated: d->sc_sequence == key| yes Evaluation Count:2 | yes Evaluation Count:443 |
| 2-443 |
| 460 | return; executed: return;Execution Count:2 | 2 |
| 461 | QAPP_CHECK("setKey"); never executed: return; partially evaluated: !(static_cast<QApplication *>(QCoreApplication::instance()))| no Evaluation Count:0 | yes Evaluation Count:443 |
| 0-443 |
| 462 | d->sc_sequence = key; executed (the execution status of this line is deduced): d->sc_sequence = key; | - |
| 463 | d->redoGrab(qApp->d_func()->shortcutMap); executed (the execution status of this line is deduced): d->redoGrab((static_cast<QApplication *>(QCoreApplication::instance()))->d_func()->shortcutMap); | - |
| 464 | } executed: }Execution Count:443 | 443 |
| 465 | | - |
| 466 | QKeySequence QShortcut::key() const | - |
| 467 | { | - |
| 468 | Q_D(const QShortcut); never executed (the execution status of this line is deduced): const QShortcutPrivate * const d = d_func(); | - |
| 469 | return d->sc_sequence; never executed: return d->sc_sequence; | 0 |
| 470 | } | - |
| 471 | | - |
| 472 | /*! | - |
| 473 | \property QShortcut::enabled | - |
| 474 | \brief whether the shortcut is enabled | - |
| 475 | | - |
| 476 | An enabled shortcut emits the activated() or activatedAmbiguously() | - |
| 477 | signal when a QShortcutEvent occurs that matches the shortcut's | - |
| 478 | key() sequence. | - |
| 479 | | - |
| 480 | If the application is in \c WhatsThis mode the shortcut will not emit | - |
| 481 | the signals, but will show the "What's This?" text instead. | - |
| 482 | | - |
| 483 | By default, this property is true. | - |
| 484 | | - |
| 485 | \sa whatsThis | - |
| 486 | */ | - |
| 487 | void QShortcut::setEnabled(bool enable) | - |
| 488 | { | - |
| 489 | Q_D(QShortcut); executed (the execution status of this line is deduced): QShortcutPrivate * const d = d_func(); | - |
| 490 | if (d->sc_enabled == enable) evaluated: d->sc_enabled == enable| yes Evaluation Count:1 | yes Evaluation Count:18 |
| 1-18 |
| 491 | return; executed: return;Execution Count:1 | 1 |
| 492 | QAPP_CHECK("setEnabled"); never executed: return; partially evaluated: !(static_cast<QApplication *>(QCoreApplication::instance()))| no Evaluation Count:0 | yes Evaluation Count:18 |
| 0-18 |
| 493 | d->sc_enabled = enable; executed (the execution status of this line is deduced): d->sc_enabled = enable; | - |
| 494 | qApp->d_func()->shortcutMap.setShortcutEnabled(enable, d->sc_id, this); executed (the execution status of this line is deduced): (static_cast<QApplication *>(QCoreApplication::instance()))->d_func()->shortcutMap.setShortcutEnabled(enable, d->sc_id, this); | - |
| 495 | } executed: }Execution Count:18 | 18 |
| 496 | | - |
| 497 | bool QShortcut::isEnabled() const | - |
| 498 | { | - |
| 499 | Q_D(const QShortcut); never executed (the execution status of this line is deduced): const QShortcutPrivate * const d = d_func(); | - |
| 500 | return d->sc_enabled; never executed: return d->sc_enabled; | 0 |
| 501 | } | - |
| 502 | | - |
| 503 | /*! | - |
| 504 | \property QShortcut::context | - |
| 505 | \brief the context in which the shortcut is valid | - |
| 506 | | - |
| 507 | A shortcut's context decides in which circumstances a shortcut is | - |
| 508 | allowed to be triggered. The normal context is Qt::WindowShortcut, | - |
| 509 | which allows the shortcut to trigger if the parent (the widget | - |
| 510 | containing the shortcut) is a subwidget of the active top-level | - |
| 511 | window. | - |
| 512 | | - |
| 513 | By default, this property is set to Qt::WindowShortcut. | - |
| 514 | */ | - |
| 515 | void QShortcut::setContext(Qt::ShortcutContext context) | - |
| 516 | { | - |
| 517 | Q_D(QShortcut); never executed (the execution status of this line is deduced): QShortcutPrivate * const d = d_func(); | - |
| 518 | if(d->sc_context == context) never evaluated: d->sc_context == context | 0 |
| 519 | return; | 0 |
| 520 | QAPP_CHECK("setContext"); never executed: return; never evaluated: !(static_cast<QApplication *>(QCoreApplication::instance())) | 0 |
| 521 | d->sc_context = context; never executed (the execution status of this line is deduced): d->sc_context = context; | - |
| 522 | d->redoGrab(qApp->d_func()->shortcutMap); never executed (the execution status of this line is deduced): d->redoGrab((static_cast<QApplication *>(QCoreApplication::instance()))->d_func()->shortcutMap); | - |
| 523 | } | 0 |
| 524 | | - |
| 525 | Qt::ShortcutContext QShortcut::context() const | - |
| 526 | { | - |
| 527 | Q_D(const QShortcut); never executed (the execution status of this line is deduced): const QShortcutPrivate * const d = d_func(); | - |
| 528 | return d->sc_context; never executed: return d->sc_context; | 0 |
| 529 | } | - |
| 530 | | - |
| 531 | /*! | - |
| 532 | \property QShortcut::whatsThis | - |
| 533 | \brief the shortcut's "What's This?" help text | - |
| 534 | | - |
| 535 | The text will be shown when the application is in "What's | - |
| 536 | This?" mode and the user types the shortcut key() sequence. | - |
| 537 | | - |
| 538 | To set "What's This?" help on a menu item (with or without a | - |
| 539 | shortcut key), set the help on the item's action. | - |
| 540 | | - |
| 541 | By default, this property contains an empty string. | - |
| 542 | | - |
| 543 | \sa QWhatsThis::inWhatsThisMode(), QAction::setWhatsThis() | - |
| 544 | */ | - |
| 545 | void QShortcut::setWhatsThis(const QString &text) | - |
| 546 | { | - |
| 547 | Q_D(QShortcut); never executed (the execution status of this line is deduced): QShortcutPrivate * const d = d_func(); | - |
| 548 | d->sc_whatsthis = text; never executed (the execution status of this line is deduced): d->sc_whatsthis = text; | - |
| 549 | } | 0 |
| 550 | | - |
| 551 | QString QShortcut::whatsThis() const | - |
| 552 | { | - |
| 553 | Q_D(const QShortcut); never executed (the execution status of this line is deduced): const QShortcutPrivate * const d = d_func(); | - |
| 554 | return d->sc_whatsthis; never executed: return d->sc_whatsthis; | 0 |
| 555 | } | - |
| 556 | | - |
| 557 | /*! | - |
| 558 | \property QShortcut::autoRepeat | - |
| 559 | \brief whether the shortcut can auto repeat | - |
| 560 | \since 4.2 | - |
| 561 | | - |
| 562 | If true, the shortcut will auto repeat when the keyboard shortcut | - |
| 563 | combination is held down, provided that keyboard auto repeat is | - |
| 564 | enabled on the system. | - |
| 565 | The default value is true. | - |
| 566 | */ | - |
| 567 | void QShortcut::setAutoRepeat(bool on) | - |
| 568 | { | - |
| 569 | Q_D(QShortcut); never executed (the execution status of this line is deduced): QShortcutPrivate * const d = d_func(); | - |
| 570 | if (d->sc_autorepeat == on) never evaluated: d->sc_autorepeat == on | 0 |
| 571 | return; | 0 |
| 572 | QAPP_CHECK("setAutoRepeat"); never executed: return; never evaluated: !(static_cast<QApplication *>(QCoreApplication::instance())) | 0 |
| 573 | d->sc_autorepeat = on; never executed (the execution status of this line is deduced): d->sc_autorepeat = on; | - |
| 574 | qApp->d_func()->shortcutMap.setShortcutAutoRepeat(on, d->sc_id, this); never executed (the execution status of this line is deduced): (static_cast<QApplication *>(QCoreApplication::instance()))->d_func()->shortcutMap.setShortcutAutoRepeat(on, d->sc_id, this); | - |
| 575 | } | 0 |
| 576 | | - |
| 577 | bool QShortcut::autoRepeat() const | - |
| 578 | { | - |
| 579 | Q_D(const QShortcut); never executed (the execution status of this line is deduced): const QShortcutPrivate * const d = d_func(); | - |
| 580 | return d->sc_autorepeat; never executed: return d->sc_autorepeat; | 0 |
| 581 | } | - |
| 582 | | - |
| 583 | /*! | - |
| 584 | Returns the shortcut's ID. | - |
| 585 | | - |
| 586 | \sa QShortcutEvent::shortcutId() | - |
| 587 | */ | - |
| 588 | int QShortcut::id() const | - |
| 589 | { | - |
| 590 | Q_D(const QShortcut); never executed (the execution status of this line is deduced): const QShortcutPrivate * const d = d_func(); | - |
| 591 | return d->sc_id; never executed: return d->sc_id; | 0 |
| 592 | } | - |
| 593 | | - |
| 594 | /*! | - |
| 595 | \internal | - |
| 596 | */ | - |
| 597 | bool QShortcut::event(QEvent *e) | - |
| 598 | { | - |
| 599 | Q_D(QShortcut); executed (the execution status of this line is deduced): QShortcutPrivate * const d = d_func(); | - |
| 600 | bool handled = false; executed (the execution status of this line is deduced): bool handled = false; | - |
| 601 | if (d->sc_enabled && e->type() == QEvent::Shortcut) { partially evaluated: d->sc_enabled| yes Evaluation Count:74 | no Evaluation Count:0 |
partially evaluated: e->type() == QEvent::Shortcut| yes Evaluation Count:74 | no Evaluation Count:0 |
| 0-74 |
| 602 | QShortcutEvent *se = static_cast<QShortcutEvent *>(e); executed (the execution status of this line is deduced): QShortcutEvent *se = static_cast<QShortcutEvent *>(e); | - |
| 603 | if (se->shortcutId() == d->sc_id && se->key() == d->sc_sequence){ partially evaluated: se->shortcutId() == d->sc_id| yes Evaluation Count:74 | no Evaluation Count:0 |
partially evaluated: se->key() == d->sc_sequence| yes Evaluation Count:74 | no Evaluation Count:0 |
| 0-74 |
| 604 | #ifndef QT_NO_WHATSTHIS | - |
| 605 | if (QWhatsThis::inWhatsThisMode()) { partially evaluated: QWhatsThis::inWhatsThisMode()| no Evaluation Count:0 | yes Evaluation Count:74 |
| 0-74 |
| 606 | QWhatsThis::showText(QCursor::pos(), d->sc_whatsthis); never executed (the execution status of this line is deduced): QWhatsThis::showText(QCursor::pos(), d->sc_whatsthis); | - |
| 607 | handled = true; never executed (the execution status of this line is deduced): handled = true; | - |
| 608 | } else | 0 |
| 609 | #endif | - |
| 610 | if (se->isAmbiguous()) evaluated: se->isAmbiguous()| yes Evaluation Count:20 | yes Evaluation Count:54 |
| 20-54 |
| 611 | emit activatedAmbiguously(); executed: activatedAmbiguously();Execution Count:20 | 20 |
| 612 | else | - |
| 613 | emit activated(); executed: activated();Execution Count:54 | 54 |
| 614 | handled = true; executed (the execution status of this line is deduced): handled = true; | - |
| 615 | } executed: }Execution Count:74 | 74 |
| 616 | } executed: }Execution Count:74 | 74 |
| 617 | return handled; executed: return handled;Execution Count:74 | 74 |
| 618 | } | - |
| 619 | #endif // QT_NO_SHORTCUT | - |
| 620 | | - |
| 621 | QT_END_NAMESPACE | - |
| 622 | | - |
| | |