Тип 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.