Класс QShortcut

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

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

Свойства

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

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

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

Сигналы

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

Статические открытые члены

• 9 статических открытых членов унаследовано от QObject

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

• 1 открытый слот унаследован от 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 = 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

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