Класс QShortcut

Класс QShortcut используется для создания сочетаний клавиш. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• 1 свойство унаследовано от QObject

Открытые функции

• 34 открытых функции унаследованы от QObject

Сигналы

• 2 сигнала унаследованы от QObject

Дополнительные унаследованные члены

• 1 открытый слот унаследован от QObject
• 1 открытая переменная унаследована от QObject
• 10 статических открытых членов унаследованы от QObject
• 9 защищённых функций унаследованы от QObject
• 2 защищённых переменных унаследованы от QObject

Подробное описание

Класс QShortcut используется для создания сочетаний клавиш.

Класс QShortcut предоставляет способ подключения сочетаний клавиш к механизму сигналов и слотов Qt, чтобы объекты могли получать информацию о выполнении сочетания клавиш. Сочетание может содержать все нажатия клавиш, необходимые для описания сочетания клавиш, включая состояния клавиш-модификаторов, таких как Shift, Ctrl и Alt.

На некоторых виджетах использование '&' перед символом автоматически создаст мнемонику (сочетание клавиш) для этого символа, например, "E&xit" создаст сочетание Alt+X (используйте '&&', чтобы отобразить фактическое амперсанд). Виджет может потреблять и выполнять действие для данного сочетания клавиш. В X11 амперсанд не будет отображаться, а символ будет подчеркнут. В Windows сочетания клавиш обычно не отображаются, пока пользователь не нажмёт клавишу Alt, но это можно настроить. В Mac сочетания клавиш по умолчанию отключены. Вызовите qt_set_sequence_auto_mnemonic(), чтобы включить их. Однако, поскольку мнемонические сочетания клавиш не соответствуют рекомендациям Aqua, Qt не будет отображать символ сочетания клавиш подчеркнутым.

Для приложений, использующих меню, может быть удобнее использовать удобные функции, предоставляемые классом QMenu, для назначения сочетаний клавиш элементам меню при их создании. В качестве альтернативы, сочетания клавиш могут быть связаны с другими типами действий в классе QAction.

Самый простой способ создать сочетание для определённого виджета — это создать сочетание с последовательностью клавиш. Например:

shortcut = new QShortcut(QKeySequence(tr("Ctrl+O", "File|Open")),
                         parent);

Когда пользователь вводит последовательность клавиш для данного сочетания, сигнал activated() сочетания подаётся. (В случае неоднозначности подаётся сигнал activatedAmbiguously().) Сочетание отслеживается циклом событий Qt, когда родительский виджет сочетания получает события.

Последовательность клавиш сочетания может быть задана с помощью setKey() и получена с помощью key(). Сочетание можно включить или отключить с помощью setEnabled(), а текстовую подсказку "Что это?" можно задать с помощью setWhatsThis().

См. также QShortcutEvent, QKeySequence и QAction.

setKey(0);                  // no signal emitted
setKey(QKeySequence());     // no signal emitted
setKey(0x3b1);              // Greek letter alpha
setKey(Qt::Key_D);              // 'd', e.g. to delete
setKey('q');                // 'q', e.g. to quit
setKey(Qt::CTRL + Qt::Key_P);       // Ctrl+P, e.g. to print document
setKey("Ctrl+P");           // Ctrl+P, e.g. to print document

Документация функций-членов

QShortcut::QShortcut(QWidget *parent)

Конструирует объект QShortcut для виджета parent. Поскольку последовательность клавиш сочетания не указана, сочетание клавиш не будет генерировать сигналы.

См. также setKey().

QShortcut::QShortcut(const QKeySequence &key, QWidget *parent, const char *member = nullptr, const char *ambiguousMember = nullptr, Qt::ShortcutContext context = Qt::WindowShortcut)

Конструирует объект QShortcut для виджета parent. Сочетание клавиш действует на его родительский элемент, прослушивая события QShortcutEvent, соответствующие последовательности клавиш key. В зависимости от неоднозначности события, сочетание клавиш вызовет функцию member или функцию ambiguousMember, если нажатие клавиш находилось в контексте сочетания клавиш context.

[virtual] QShortcut::~QShortcut()

Удаляет сочетание клавиш.

[signal] void QShortcut::activated()

Этот сигнал генерируется при вводе пользователем последовательности клавиш сочетания.

См. также activatedAmbiguously().

[signal] void QShortcut::activatedAmbiguously()

Когда последовательность клавиш вводится с клавиатуры, она считается неоднозначной, пока она соответствует началу более одного сочетания клавиш.

Когда последовательность клавиш сочетания завершается, activatedAmbiguously() генерируется, если последовательность клавиш по-прежнему неоднозначна (т.е., она является началом одной или нескольких других последовательностей сочетаний клавиш). В этом случае сигнал activated() не генерируется.

См. также activated().

int QShortcut::id() const

Возвращает идентификатор сочетания клавиш.

См. также QShortcutEvent::shortcutId().

QWidget *QShortcut::parentWidget() const

Возвращает родительский виджет сочетания клавиш.