Тип QML VirtualKeyboardSettings

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

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

Свойства

• activeLocales : список<строка>
• availableLocales : список<строка>
• defaultDictionaryDisabled : bool
• defaultInputMethodDisabled : bool
• fullScreenMode : bool
• handwritingModeDisabled : bool
• hwrTimeoutForAlphabetic : bool
• hwrTimeoutForCjk : bool
• inputMethodHints : int
• locale : строка
• styleName : строка
• userDataPath : bool
• wordCandidateList
  • wordCandidateList.alwaysVisible : bool
  • wordCandidateList.autoHideDelay : int

Сигналы

• userDataReset()

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

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

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

Например, чтобы изменить стиль клавиатуры в приложении:

Component.onCompleted: VirtualKeyboardSettings.styleName = "retro"

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

[с версии QtQuick.VirtualKeyboard.Settings 2.0] activeLocales : список<строка>

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

Список активных языков является подмножеством доступных языков и может использоваться для ограничения списка доступных языков в течение жизненного цикла приложения.

Список языков будет отображаться в соответствии с указанным порядком.

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

[только для чтения, с версии QtQuick.VirtualKeyboard.Settings 2.0] availableLocales : список<строка>

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

Этот список является только для чтения и зависит от конфигурации виртуальной клавиатуры во время сборки.

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

[с версии QtQuick.VirtualKeyboard.Settings 6.1] defaultDictionaryDisabled : bool

Это свойство отключает словарь по умолчанию. Цель этого параметра — возможность использования только пользовательского словаря вместо стандартного словаря.

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

[с версии QtQuick.VirtualKeyboard.Settings 6.1] defaultInputMethodDisabled : bool

Это свойство отключает метод ввода по умолчанию. Цель этого параметра — возможность переопределения метода ввода по умолчанию простым методом ввода, отключив его функциональность.

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

[с версии QtQuick.VirtualKeyboard.Settings 2.2] fullScreenMode : bool

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

В полноэкранном режиме виртуальная клавиатура копирует содержимое фокусированного поля ввода в полноэкранное поле ввода, расположенное в верхней части клавиатуры.

Например, чтобы активировать полноэкранный режим, когда соотношение сторон экрана больше, чем 16:9:

Binding {
    target: VirtualKeyboardSettings
    property: "fullScreenMode"
    value: (Screen.width / Screen.height) > (16.0 / 9.0)
}

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

[с версии QtQuick.VirtualKeyboard.Settings 6.1] handwritingModeDisabled : bool

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

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

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

[с версии QtQuick.VirtualKeyboard.Settings 6.1] hwrTimeoutForAlphabetic : bool

Это свойство устанавливает тайм-аут распознавания рукописного ввода для языков алфавита.

По умолчанию тайм-аут составляет 500 миллисекунд.

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

[с версии QtQuick.VirtualKeyboard.Settings 6.1] hwrTimeoutForCjk : bool

Это свойство устанавливает тайм-аут распознавания рукописного ввода для языков китайского, японского и корейского.

По умолчанию тайм-аут составляет 500 миллисекунд.

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

[с версии QtQuick.VirtualKeyboard.Settings 6.1] inputMethodHints : int

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

Значение этого свойства комбинируется с подсказками метода ввода из элемента управления вводом. Например, чтобы отключить прогнозирование текста, это свойство можно установить в Qt::ImhNoPredictiveText.

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

[с версии QtQuick.VirtualKeyboard.Settings 2.0] locale : строка

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

Если язык не указан, используется язык по умолчанию системы.

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

Язык поддерживается, если он включен в список availableLocales.

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

styleName : строка

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

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

[с версии QtQuick.VirtualKeyboard.Settings 6.1] userDataPath : bool

Это свойство устанавливает путь к пользовательским данным для виртуальной клавиатуры и её плагинов.

По умолчанию путь к пользовательским данным устанавливается в GenericConfigLocation + "/qtvirtualkeyboard".

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

[с версии QtQuick.VirtualKeyboard.Settings 2.2] wordCandidateList.alwaysVisible : bool

Это свойство QML было введено в QtQuick.VirtualKeyboard.Settings 2.2.

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

userDataReset()

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

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