Класс QShortcut

Класс 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(const QKeySequence &key, QWidget *parent, const char *member = nullptr, const char *ambiguousMember = nullptr, Qt::ShortcutContext shortcutContext = Qt::WindowShortcut)

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

QShortcut::QShortcut(QWidget *parent)

Создаёт объект QShortcut для виджета parent. Так как последовательность клавиш сочетания не указана, сочетание клавиш не будет генерировать никаких сигналов.

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

[signal] void QShortcut::activated()

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

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

[signal] void QShortcut::activatedAmbiguously()

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

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

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

[virtual] QShortcut::~QShortcut()

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

int QShortcut::id() const

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

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

QWidget *QShortcut::parentWidget() const

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