Home · All Classes · Modules ·

A global shortcut aka "hotkey". More...

 #include <QxtGlobalShortcut>

Inherits QObject.

• List of all members, including inherited members

Properties

• bool enabled
• QKeySequence shortcut

Public Functions

• explicit QxtGlobalShortcut ( QObject * parent = 0 )
• explicit QxtGlobalShortcut ( const QKeySequence & shortcut , QObject * parent = 0 )
• virtual ~QxtGlobalShortcut ( )

Public Slots

• void setEnabled ( bool enabled = true )
• void setDisabled ( bool disabled = true )

Signals

• void activated ( )

Detailed Description

A global shortcut triggers even if the application is not active. This makes it easy to implement applications that react to certain shortcuts still if some other application is active or if the application is for example minimized to the system tray.

Note: QxtGlobalShortcut requires QxtApplication.

Member Documentation

bool enabled

This property holds whether the shortcut is enabled.

A disabled shortcut does not get activated.

The default value is true.

See also: setDisabled()

Access Functions:

• read: bool isEnabled ( ) const
• write: void setEnabled ( bool enabled = true )

QKeySequence shortcut

This property holds the shortcut key sequence.

Note: Notice that corresponding key press and release events are not delivered for registered global shortcuts even if they are disabled. Also, comma separated key sequences are not supported. Only the first part is used:

qxtShortcut->setShortcut(QKeySequence("Ctrl+Alt+A,Ctrl+Alt+B"));
Q_ASSERT(qxtShortcut->shortcut() == QKeySequence("Ctrl+Alt+A"));

Access Functions:

• read: QKeySequence shortcut ( ) const
• write: bool setShortcut ( const QKeySequence & shortcut )

explicit QxtGlobalShortcut ( QObject * parent = 0 )

explicit QxtGlobalShortcut ( const QKeySequence & shortcut , QObject * parent = 0 )

virtual ~QxtGlobalShortcut ( )

void setEnabled ( bool enabled = true )

void setDisabled ( bool disabled = true )

Sets the shortcut disabled.

See also: enabled

void activated ( )

This signal is emitted when the user types the shortcut's key sequence.

See also: shortcut