Тип QML Краткая_клавиша

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

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

Свойства

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

Сигналы

• activated()
• activatedAmbiguously()

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

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

Item {
    id: view

    property int currentIndex

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

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

См. также Клавиши и shortcutOverride().

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

autoRepeat : bool

Это свойство содержит значение, определяющее, может ли сочетание клавиш автоматически повторяться.

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

context : перечисление

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

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

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

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

enabled : bool

Это свойство содержит значение, определяющее, включено ли сочетание клавиш.

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

[с версии 5.6] nativeText : строка

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

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

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

[с версии 5.6] portableText : строка

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

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

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

sequence : последовательность_клавиш

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

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

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

См. также sequences.

[с версии 5.9] sequences : список<последовательность_клавиш>

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

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

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

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

activated()

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

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

activatedAmbiguously()

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

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