Тип QML InputPanel

Обеспечивает виртуальную клавиатуру UI. Подробнее...

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

Свойства

• active : bool
• externalLanguageSwitchEnabled : bool

Сигналы

• externalLanguageSwitch(переменная, целое число)

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

Размер клавиатуры автоматически рассчитывается на основе доступной ширины; то есть, клавиатура сохраняет соотношение сторон, заданное текущим стилем. Поэтому приложение должно устанавливать только координаты width и y для InputPanel, а не height.

Как и все другие типы QML, предоставляемые модулем, переменная среды QT_IM_MODULE должна быть установлена в значение qtvirtualkeyboard перед использованием InputPanel. Дополнительную информацию см. в разделе Загрузка плагина.

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

active : bool

Это свойство отражает активный статус панели ввода. Клавиатура должна быть отображена пользователю, когда это свойство равно true.

Это свойство было введено в QtQuick.VirtualKeyboard 2.0.

externalLanguageSwitchEnabled : bool

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

Это свойство было введено в QtQuick.VirtualKeyboard 2.4.

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

externalLanguageSwitch(переменная = localeList, целое число = currentIndex)

Этот сигнал испускается, когда externalLanguageSwitchEnabled равно true и пользователь нажимает клавишу переключения языка.

Он служит крючком для отображения пользовательского диалога выбора языка вместо встроенного всплывающего меню языка в виртуальной клавиатуре.

Параметр localeList содержит список названий языковых локалей для выбора. Для получения дополнительной информации об определённом языке используйте функцию Qt.locale(). currentIndex — индекс текущей локали в списке localeList. Этот элемент должен быть выделен как текущий в пользовательском интерфейсе.

Для выбора нового языка используйте свойство VirtualKeyboardSettings.locale.

Ниже приведён пример реализации пользовательского диалога выбора языка:

Dialog {
    id: languageDialog
    title: "Select Input Language"
    modality: Qt.ApplicationModal

    function show(localeList, currentIndex) {
        languageListModel.clear()
        for (var i = 0; i < localeList.length; i++) {
            languageListModel.append({localeName: localeList[i], displayName: Qt.locale(localeList[i]).nativeLanguageName})
        }
        languageListView.currentIndex = currentIndex
        languageListView.positionViewAtIndex(currentIndex, ListView.Center)
        languageDialog.visible = true
    }

    contentItem: ListView {
        id: languageListView
        model: ListModel {
            id: languageListModel
            function selectItem(index) {
                VirtualKeyboardSettings.locale = languageListModel.get(index).localeName
                languageDialog.visible = false
            }
        }
        delegate: Item {
            id: languageListItem
            width: languageNameTextMetrics.width * 17
            height: languageNameTextMetrics.height + languageListLabel.anchors.topMargin + languageListLabel.anchors.bottomMargin
            Text {
                id: languageListLabel
                anchors.left: parent.left
                anchors.top: parent.top
                anchors.leftMargin: languageNameTextMetrics.height / 2
                anchors.rightMargin: anchors.leftMargin
                anchors.topMargin: languageNameTextMetrics.height / 3
                anchors.bottomMargin: anchors.topMargin
                text: languageNameFormatter.elidedText
                color: "#5CAA15"
                font {
                    weight: Font.Normal
                    pixelSize: 28
                }
            }
            TextMetrics {
                id: languageNameTextMetrics
                font {
                    weight: Font.Normal
                    pixelSize: 28
                }
                text: "X"
            }
            TextMetrics {
                id: languageNameFormatter
                font {
                    weight: Font.Normal
                    pixelSize: 28
                }
                elide: Text.ElideRight
                elideWidth: languageListItem.width - languageListLabel.anchors.leftMargin - languageListLabel.anchors.rightMargin
                text: displayName
            }
            MouseArea {
                anchors.fill: parent
                hoverEnabled: true
                onClicked: {
                    if (index === -1)
                        return
                    parent.ListView.view.currentIndex = index
                    parent.ListView.view.model.selectItem(index)
                }
            }
            states: State {
                name: "current"
                when: languageListItem.ListView.isCurrentItem
                PropertyChanges {
                    target: languageListLabel
                    color: "black"
                }
            }
        }
    }
}

Затем диалог объявляется:

LanguageDialog {
    id: languageDialog
    width: 400
    height: 400
}

В приложении InputPanel добавьте следующий код:

InputPanel {
    id: inputPanel
    externalLanguageSwitchEnabled: true
    onExternalLanguageSwitch: languageDialog.show(localeList, currentIndex)
    // ...
}

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

Этот сигнал был введён в QtQuick.VirtualKeyboard 2.4.