Тип 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 : перечисление

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

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

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

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

enabled : bool

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

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

nativeText : строка

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

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

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

portableText : строка

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

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

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

sequence : keysequence

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

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

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

См. также sequences.

sequences : список<keysequence>

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

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

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

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

activated()

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

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

activatedAmbiguously()

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

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