Тип 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 : строка

Это свойство предоставляет последовательность клавиш сочетания в виде строки в "портативном" формате, подходящем для чтения и записи в файл. Во многих случаях, она будет выглядеть аналогично строке native text на 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.