Qt 4.8
|
The QShortcut class is used to create keyboard shortcuts. More...
#include <qshortcut.h>
Signals | |
void | activated () |
This signal is emitted when the user types the shortcut's key sequence. More... | |
void | activatedAmbiguously () |
When a key sequence is being typed at the keyboard, it is said to be ambiguous as long as it matches the start of more than one shortcut. More... | |
Signals inherited from QObject | |
void | destroyed (QObject *=0) |
This signal is emitted immediately before the object obj is destroyed, and can not be blocked. More... | |
Public Functions | |
bool | autoRepeat () const |
Qt::ShortcutContext | context () |
int | id () const |
Returns the shortcut's ID. More... | |
bool | isEnabled () const |
QKeySequence | key () const |
QWidget * | parentWidget () const |
Returns the shortcut's parent widget. More... | |
QShortcut (QWidget *parent) | |
Constructs a QShortcut object for the parent widget. More... | |
QShortcut (const QKeySequence &key, QWidget *parent, const char *member=0, const char *ambiguousMember=0, Qt::ShortcutContext context=Qt::WindowShortcut) | |
Constructs a QShortcut object for the parent widget. More... | |
void | setAutoRepeat (bool on) |
void | setContext (Qt::ShortcutContext context) |
void | setEnabled (bool enable) |
void | setKey (const QKeySequence &key) |
void | setWhatsThis (const QString &text) |
QString | whatsThis () const |
~QShortcut () | |
Destroys the shortcut. More... | |
Public Functions inherited from QObject | |
bool | blockSignals (bool b) |
If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it). More... | |
const QObjectList & | children () const |
Returns a list of child objects. More... | |
bool | connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const |
bool | disconnect (const char *signal=0, const QObject *receiver=0, const char *member=0) |
bool | disconnect (const QObject *receiver, const char *member=0) |
void | dumpObjectInfo () |
Dumps information about signal connections, etc. More... | |
void | dumpObjectTree () |
Dumps a tree of children to the debug output. More... | |
QList< QByteArray > | dynamicPropertyNames () const |
Returns the names of all properties that were dynamically added to the object using setProperty(). More... | |
virtual bool | eventFilter (QObject *, QEvent *) |
Filters events if this object has been installed as an event filter for the watched object. More... | |
template<typename T > | |
T | findChild (const QString &aName=QString()) const |
Returns the child of this object that can be cast into type T and that is called name, or 0 if there is no such object. More... | |
template<typename T > | |
QList< T > | findChildren (const QString &aName=QString()) const |
Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects. More... | |
template<typename T > | |
QList< T > | findChildren (const QRegExp &re) const |
bool | inherits (const char *classname) const |
Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false. More... | |
void | installEventFilter (QObject *) |
Installs an event filter filterObj on this object. More... | |
bool | isWidgetType () const |
Returns true if the object is a widget; otherwise returns false. More... | |
void | killTimer (int id) |
Kills the timer with timer identifier, id. More... | |
virtual const QMetaObject * | metaObject () const |
Returns a pointer to the meta-object of this object. More... | |
void | moveToThread (QThread *thread) |
Changes the thread affinity for this object and its children. More... | |
QString | objectName () const |
QObject * | parent () const |
Returns a pointer to the parent object. More... | |
QVariant | property (const char *name) const |
Returns the value of the object's name property. More... | |
Q_INVOKABLE | QObject (QObject *parent=0) |
Constructs an object with parent object parent. More... | |
void | removeEventFilter (QObject *) |
Removes an event filter object obj from this object. More... | |
void | setObjectName (const QString &name) |
void | setParent (QObject *) |
Makes the object a child of parent. More... | |
bool | setProperty (const char *name, const QVariant &value) |
Sets the value of the object's name property to value. More... | |
void | setUserData (uint id, QObjectUserData *data) |
bool | signalsBlocked () const |
Returns true if signals are blocked; otherwise returns false. More... | |
int | startTimer (int interval) |
Starts a timer and returns a timer identifier, or returns zero if it could not start a timer. More... | |
QThread * | thread () const |
Returns the thread in which the object lives. More... | |
QObjectUserData * | userData (uint id) const |
virtual | ~QObject () |
Destroys the object, deleting all its child objects. More... | |
Protected Functions | |
bool | event (QEvent *e) |
Protected Functions inherited from QObject | |
virtual void | childEvent (QChildEvent *) |
This event handler can be reimplemented in a subclass to receive child events. More... | |
virtual void | connectNotify (const char *signal) |
This virtual function is called when something has been connected to signal in this object. More... | |
virtual void | customEvent (QEvent *) |
This event handler can be reimplemented in a subclass to receive custom events. More... | |
virtual void | disconnectNotify (const char *signal) |
This virtual function is called when something has been disconnected from signal in this object. More... | |
QObject (QObjectPrivate &dd, QObject *parent=0) | |
int | receivers (const char *signal) const |
Returns the number of receivers connected to the signal. More... | |
QObject * | sender () const |
Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns 0. More... | |
int | senderSignalIndex () const |
virtual void | timerEvent (QTimerEvent *) |
This event handler can be reimplemented in a subclass to receive timer events for the object. More... | |
Properties | |
bool | autoRepeat |
whether the shortcut can auto repeat More... | |
Qt::ShortcutContext | context |
the context in which the shortcut is valid More... | |
bool | enabled |
whether the shortcut is enabled More... | |
QKeySequence | key |
the shortcut's key sequence More... | |
QString | whatsThis |
the shortcut's "What's This?" help text More... | |
Additional Inherited Members | |
Public Slots inherited from QObject | |
void | deleteLater () |
Schedules this object for deletion. More... | |
Static Public Functions inherited from QObject | |
static bool | connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection) |
Creates a connection of the given type from the signal in the sender object to the method in the receiver object. More... | |
static bool | connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection) |
static bool | disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member) |
Disconnects signal in object sender from method in object receiver. More... | |
static bool | disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member) |
static uint | registerUserData () |
static QString | tr (const char *sourceText, const char *comment=0, int n=-1) |
static QString | trUtf8 (const char *sourceText, const char *comment=0, int n=-1) |
Static Public Variables inherited from QObject | |
static const QMetaObject | staticMetaObject |
This variable stores the meta-object for the class. More... | |
Protected Variables inherited from QObject | |
QScopedPointer< QObjectData > | d_ptr |
Static Protected Variables inherited from QObject | |
static const QMetaObject | staticQtMetaObject |
Related Functions inherited from QObject | |
T | qFindChildqFindChildren (const QObject *obj, const QString &name)() |
QList< T > | qFindChildrenqFindChildren (const QObject *obj, const QString &name)() |
QList< T > | qFindChildrenqFindChildren (const QObject *obj, const QRegExp ®Exp)() |
T * | qobject_cast (QObject *object) |
QObjectList | |
void * | qt_find_obj_child (QObject *parent, const char *type, const QString &name) |
Returns a pointer to the object named name that inherits type and with a given parent. More... | |
The QShortcut class is used to create keyboard shortcuts.
The QShortcut class provides a way of connecting keyboard shortcuts to Qt's signals and slots mechanism, so that objects can be informed when a shortcut is executed. The shortcut can be set up to contain all the key presses necessary to describe a keyboard shortcut, including the states of modifier keys such as Shift, Ctrl, and Alt.
On certain widgets, using '&' in front of a character will automatically create a mnemonic (a shortcut) for that character, e.g. "E&xit" will create the shortcut Alt+X (use '&&' to display an actual ampersand). The widget might consume and perform an action on a given shortcut. On X11 the ampersand will not be shown and the character will be underlined. On Windows, shortcuts are normally not displayed until the user presses the Alt key, but this is a setting the user can change. On Mac, shortcuts are disabled by default. Call qt_set_sequence_auto_mnemonic() to enable them. However, because mnemonic shortcuts do not fit in with Aqua's guidelines, Qt will not show the shortcut character underlined.
For applications that use menus, it may be more convenient to use the convenience functions provided in the QMenu class to assign keyboard shortcuts to menu items as they are created. Alternatively, shortcuts may be associated with other types of actions in the QAction class.
The simplest way to create a shortcut for a particular widget is to construct the shortcut with a key sequence. For example:
When the user types the key sequence for a given shortcut, the shortcut's activated() signal is emitted. (In the case of ambiguity, the activatedAmbiguously() signal is emitted.) A shortcut is "listened for" by Qt's event loop when the shortcut's parent widget is receiving events.
A shortcut's key sequence can be set with setKey() and retrieved with key(). A shortcut can be enabled or disabled with setEnabled(), and can have "What's This?" help text set with setWhatsThis().
Definition at line 57 of file qshortcut.h.
|
explicit |
Constructs a QShortcut object for the parent widget.
Since no shortcut key sequence is specified, the shortcut will not emit any signals.
Definition at line 198 of file qshortcut.cpp.
QShortcut::QShortcut | ( | const QKeySequence & | key, |
QWidget * | parent, | ||
const char * | member = 0 , |
||
const char * | ambiguousMember = 0 , |
||
Qt::ShortcutContext | context = Qt::WindowShortcut |
||
) |
Constructs a QShortcut object for the parent widget.
The shortcut operates on its parent, listening for QShortcutEvent that match the key sequence. Depending on the ambiguity of the event, the shortcut will call the member function, or the ambiguousMember function, if the key press was in the shortcut's context.
Definition at line 212 of file qshortcut.cpp.
QShortcut::~QShortcut | ( | ) |
|
signal |
This signal is emitted when the user types the shortcut's key sequence.
Referenced by event(), and QShortcut().
|
signal |
When a key sequence is being typed at the keyboard, it is said to be ambiguous as long as it matches the start of more than one shortcut.
When a shortcut's key sequence is completed, activatedAmbiguously() is emitted if the key sequence is still ambiguous (i.e., it is the start of one or more other shortcuts). The activated() signal is not emitted in this case.
Referenced by event(), and QShortcut().
bool QShortcut::autoRepeat | ( | ) | const |
Referenced by setAutoRepeat().
Qt::ShortcutContext QShortcut::context | ( | ) |
Referenced by QShortcut(), and setContext().
|
protectedvirtual |
Reimplemented from QObject.
Definition at line 407 of file qshortcut.cpp.
int QShortcut::id | ( | ) | const |
Returns the shortcut's ID.
Definition at line 398 of file qshortcut.cpp.
bool QShortcut::isEnabled | ( | ) | const |
Definition at line 298 of file qshortcut.cpp.
QKeySequence QShortcut::key | ( | ) | const |
Referenced by QShortcut(), and setKey().
|
inline |
Returns the shortcut's parent widget.
Definition at line 90 of file qshortcut.h.
Referenced by QShortcutMap::correctContext().
void QShortcut::setAutoRepeat | ( | bool | on | ) |
Definition at line 377 of file qshortcut.cpp.
void QShortcut::setContext | ( | Qt::ShortcutContext | context | ) |
Definition at line 319 of file qshortcut.cpp.
void QShortcut::setEnabled | ( | bool | enable | ) |
Definition at line 288 of file qshortcut.cpp.
void QShortcut::setKey | ( | const QKeySequence & | key | ) |
Definition at line 254 of file qshortcut.cpp.
Referenced by QFileDialogPrivate::createWidgets().
void QShortcut::setWhatsThis | ( | const QString & | text | ) |
Definition at line 352 of file qshortcut.cpp.
QString QShortcut::whatsThis | ( | ) | const |
Referenced by setWhatsThis().
|
private |
whether the shortcut can auto repeat
If true, the shortcut will auto repeat when the keyboard shortcut combination is held down, provided that keyboard auto repeat is enabled on the system. The default value is true.
Definition at line 64 of file qshortcut.h.
|
private |
the context in which the shortcut is valid
A shortcut's context decides in which circumstances a shortcut is allowed to be triggered. The normal context is Qt::WindowShortcut, which allows the shortcut to trigger if the parent (the widget containing the shortcut) is a subwidget of the active top-level window.
By default, this property is set to Qt::WindowShortcut.
Definition at line 65 of file qshortcut.h.
|
private |
whether the shortcut is enabled
An enabled shortcut emits the activated() or activatedAmbiguously() signal when a QShortcutEvent occurs that matches the shortcut's key() sequence.
If the application is in WhatsThis
mode the shortcut will not emit the signals, but will show the "What's This?" text instead.
By default, this property is true.
Definition at line 63 of file qshortcut.h.
|
private |
the shortcut's key sequence
This is a key sequence with an optional combination of Shift, Ctrl, and Alt. The key sequence may be supplied in a number of ways:
By default, this property contains an empty key sequence.
Definition at line 61 of file qshortcut.h.
|
private |
the shortcut's "What's This?" help text
The text will be shown when the application is in "What's This?" mode and the user types the shortcut key() sequence.
To set "What's This?" help on a menu item (with or without a shortcut key), set the help on the item's action.
By default, this property contains an empty string.
Definition at line 62 of file qshortcut.h.