Класс QShortcut

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

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

Свойства

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

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

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

Сигналы

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

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

• 1 открытый слот унаследован от QObject
• 11 статические открытые члены унаследованы от QObject
• 9 защищённые функции унаследованы от 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 = Q_NULLPTR, const char *ambiguousMember = Q_NULLPTR, Qt::ShortcutContext context = Qt::WindowShortcut)

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

QShortcut::~QShortcut()

Уничтожает ярлык.

[signal] void QShortcut::activated()

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

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

[signal] void QShortcut::activatedAmbiguously()

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

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

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

int QShortcut::id() const

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

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

QWidget *QShortcut::parentWidget() const

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