Тип QML InputPanel

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

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

Свойства

• active : bool
• externalLanguageSwitchEnabled : bool

Сигналы

• externalLanguageSwitch(var localeList, int currentIndex)

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

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

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

Примечание: В вашем приложении может быть только один экземпляр InputPanel.

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

[с QtQuick.VirtualKeyboard 2.0] active : bool

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

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

[с QtQuick.VirtualKeyboard 2.4] externalLanguageSwitchEnabled : bool

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

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

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

[since QtQuick.VirtualKeyboard 2.4] externalLanguageSwitch(var localeList, int 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)
    // ...
}

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

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

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