Тип QML Shortcut

Обеспечивает горячие клавиши. Подробнее...

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

Свойства

• autoRepeat : bool
• context : перечисление
• enabled : bool
• nativeText : строка
• portableText : строка
• sequence : keysequence
• sequences : список<keysequence>

Сигналы

• activated()
• activatedAmbiguously()

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

Тип Shortcut предоставляет способ обработки горячих клавиш. Горячая клавиша может быть установлена на одну из стандартных горячих клавиш, или она может быть описана строкой, содержащей последовательность до четырёх нажатий клавиш, необходимых для активации горячей клавиши.

Item {
    id: view

    property int currentIndex

    Shortcut {
        sequence: StandardKey.NextChild
        onActivated: view.currentIndex++
    }
}

Также можно установить несколько последовательностей горячих клавиш sequences, чтобы горячая клавиша могла быть активирована с помощью нескольких различных последовательностей нажатий клавиш.

См. также Keys и shortcutOverride().

Документация по свойствам

autoRepeat : bool

Это свойство указывает, может ли горячая клавиша повторяться автоматически.

Значение по умолчанию — true.

context : enumeration

Это свойство содержит контекст горячей клавиши.

Поддерживаемые значения:

• Qt.WindowShortcut (по умолчанию) — Горячая клавиша активна, когда родительский элемент находится в активном верхнем окне.
• Qt.ApplicationShortcut — Горячая клавиша активна, когда активны окна приложения.

Shortcut {
    sequence: StandardKey.Quit
    context: Qt.ApplicationShortcut
    onActivated: Qt.quit()
}

enabled : bool

Это свойство указывает, включена ли горячая клавиша.

Значение по умолчанию — true.

[с 5.6] nativeText : string

Это свойство предоставляет последовательность клавиш горячей клавиши в виде платформозависимой строки. Это означает, что она будет отображена в переведённом виде, а на macOS она будет напоминать последовательность клавиш из строки меню. Лучше всего отображать эту строку пользователю (например, в подсказке).

Это свойство было добавлено в Qt 5.6.

См. также sequence и portableText.

[с 5.6] portableText : string

Это свойство предоставляет последовательность клавиш горячей клавиши в виде строки в "портативном" формате, подходящей для чтения и записи в файл. Во многих случаях она будет выглядеть похоже на строку native text в Windows и X11.

Это свойство было добавлено в Qt 5.6.

См. также sequence и nativeText.

sequence : keysequence

Это свойство содержит последовательность клавиш горячей клавиши. Последовательность клавиш может быть установлена на одну из стандартных горячих клавиш, или она может быть описана строкой, содержащей последовательность до четырёх нажатий клавиш, необходимых для активации горячей клавиши.

Значение по умолчанию — пустая последовательность клавиш.

Shortcut {
    sequence: "Ctrl+E,Ctrl+W"
    onActivated: edit.wrapMode = TextEdit.Wrap
}

См. также sequences.

[с 5.9] sequences : list<keysequence>

Это свойство содержит несколько последовательностей клавиш для горячей клавиши. Последовательности клавиш могут быть установлены на одну из стандартных горячих клавиш, или они могут быть описаны строками, содержащими последовательности до четырёх нажатий клавиш, необходимых для активации горячей клавиши.

Shortcut {
    sequences: [StandardKey.Cut, "Ctrl+X", "Shift+Del"]
    onActivated: edit.cut()
}

Это свойство было добавлено в Qt 5.9.

Документация по сигналам

activated()

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

Примечание: Соответствующий обработчик — onActivated.

activatedAmbiguously()

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

Примечание: Соответствующий обработчик — onActivatedAmbiguously.