Тип QML VirtualKeyboardSettings

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

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

Свойства

• activeLocales : list<string>
• availableLocales : list<string>
• defaultDictionaryDisabled : bool
• defaultInputMethodDisabled : bool
• fullScreenMode : bool
• handwritingModeDisabled : bool
• hwrTimeoutForAlphabetic : bool
• hwrTimeoutForCjk : bool
• inputMethodHints : int
• locale : string
• styleName : string
• userDataPath : bool
• wordCandidateList
  • wordCandidateList.alwaysVisible : bool
  • wordCandidateList.autoHideDelay : int

Сигналы

• userDataReset()

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

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

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

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

Component.onCompleted: VirtualKeyboardSettings.styleName = "retro"

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

[с QtQuick.VirtualKeyboard.Settings 2.0] activeLocales : list<string>

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

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

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

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

[с QtQuick.VirtualKeyboard.Settings 2.0] availableLocales : list<string>

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

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

Это свойство было добавлено в 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 : string

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

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

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

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

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

styleName : string

Это свойство предоставляет текущий стиль. Приложение может изменить стиль клавиатуры, установив свойство 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.