Тип 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++
    }
}

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

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

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

autoRepeat : bool

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

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

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

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

Доступные значения:

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

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

enabled : bool

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

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

nativeText : строка

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

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

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

portableText : строка

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

Это свойство QML было введено в 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()
}

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

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

activated()

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

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

activatedAmbiguously()

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

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