Класс QShortcut

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

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

Свойства

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

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

• 31 открытая функция унаследована от 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()

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

void QShortcut::activated()

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

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

void QShortcut::activatedAmbiguously()

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

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

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

int QShortcut::id() const

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

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

QWidget *QShortcut::parentWidget() const

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