Back to Qt.io
Contact Us Blog Download Qt

VirtualKeyboardSettings QML Type

为虚拟键盘提供设置。更多

Import Statement: import QtQuick.VirtualKeyboard.Settings
Since: QtQuick.VirtualKeyboard 1.2

属性

信号

详细描述

该类型提供 VirtualKeyboardSettings 单例，可用于配置虚拟键盘设置。

请注意，这些设置只在当前应用程序的生命周期内有效，也就是说，配置更改不是永久性的。

例如，在应用程序中更改键盘样式：

Component.onCompleted: VirtualKeyboardSettings.styleName = "retro"

属性 文档

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

该属性包含虚拟键盘的激活语言列表。

活动语言列表是可用语言的子集，可用于限制应用程序生命周期内的可用语言列表。

语言列表将根据指定的排序显示。

该属性在 QtQuick.VirtualKeyboard.Settings 2.0 中引入。


availableLocales : list<string> [read-only, since QtQuick.VirtualKeyboard.Settings 2.0]

该属性包含虚拟键盘支持的语言列表。

该列表为只读，取决于虚拟键盘的构建时配置。

该属性在 QtQuick.VirtualKeyboard.Settings 2.0 中引入。


closeOnReturn : bool [since QtQuick.VirtualKeyboard.Settings 6.8]

此属性可隐藏虚拟键盘。

当该属性设置为true 时，当释放Qt::Key_Enter 或Qt::Key_Return 键时，虚拟键盘将被隐藏。默认值为false 。

该属性在 QtQuick.VirtualKeyboard.Settings 6.8 中引入。


defaultDictionaryDisabled : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

该属性禁用默认字典。该设置的目的是仅使用自定义字典而不是标准字典。

该属性在 QtQuick.VirtualKeyboard.Settings 6.1 中引入。


defaultInputMethodDisabled : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

此属性禁用默认输入法。此设置的目的是使用普通输入法覆盖默认输入法，禁用其功能。

该属性在 QtQuick.VirtualKeyboard.Settings 6.1 中引入。


fullScreenMode : bool [since QtQuick.VirtualKeyboard.Settings 2.2]

该属性可启用虚拟键盘的全屏模式。

在全屏模式下，虚拟键盘会将聚焦输入框的内容复制到位于键盘顶部的全屏输入框。

例如，当屏幕纵横比大于 16:9 时激活全屏模式：

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

该属性在 QtQuick.VirtualKeyboard.Settings 2.2 中引入。


handwritingModeDisabled : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

如果手写输入模式在系统中可用，该属性允许禁用手写输入模式。

当该属性设置为true 时，手写按钮将从键盘布局中隐藏，用户无法切换到手写输入模式。

该属性在 QtQuick.VirtualKeyboard.Settings 6.1 中引入。


hwrTimeoutForAlphabetic : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

该属性设置字母语言的手写识别超时。

默认超时为 500 毫秒。

该属性在 QtQuick.VirtualKeyboard.Settings 6.1 中引入。


hwrTimeoutForCjk : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

该属性设置中文/日文/韩文的手写识别超时。

默认超时为500毫秒。

该属性在 QtQuick.VirtualKeyboard.Settings 6.1 中引入。


inputMethodHints : int [since QtQuick.VirtualKeyboard.Settings 6.1]

该属性允许设置持续输入法提示。

该属性的值与输入控件的输入法提示相结合。例如，要禁用预测文本输入，可将此属性设置为Qt::ImhNoPredictiveText 。

该属性在 QtQuick.VirtualKeyboard.Settings 6.1 中引入。


keySoundVolume : real [since QtQuick.VirtualKeyboard.Settings 6.9]

该属性保存按键音的音量大小。音量范围为 [0,1] 。

该属性在 QtQuick.VirtualKeyboard.Settings 6.9 中引入。


locale : string [since QtQuick.VirtualKeyboard.Settings 2.0]

该属性提供键盘的默认语言。

如果未指定locale，则使用默认的系统locale。

如果键盘语言与新的默认语言不同，则会立即更改键盘语言以反映新的语言。如果本地化设置不正确，或不在支持的本地化列表中，则会被忽略并使用默认设置。

如果本地语言包含在availableLocales 的列表中，则该语言是受支持的。

该属性在 QtQuick.VirtualKeyboard.Settings 2.0 中引入。


styleName : string

该属性提供了当前样式。应用程序可通过将 styleName 设置为不同值来更改键盘样式。

系统范围内的键盘样式可通过设置 QT_VIRTUALKEYBOARD_STYLE 环境变量来影响。


userDataPath : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

该属性为虚拟键盘及其插件设置用户数据路径。

默认情况下，用户数据路径设置为GenericConfigLocation + "/qtvirtualkeyboard"。

该属性在 QtQuick.VirtualKeyboard.Settings 6.1 中引入。


visibleFunctionKeys : enumeration [since QtQuick.VirtualKeyboard.Settings 6.6]

该设置可调整键盘布局中特定功能键的可见性，允许显示或隐藏它们。当功能键不可见时，其功能仍可通过齿轮菜单访问。

该值可以是以下标志的组合：

  • QtVirtualKeyboard.KeyboardFunctionKeys.None 所有功能键都隐藏
  • QtVirtualKeyboard.KeyboardFunctionKeys.Hide 隐藏功能键可见
  • QtVirtualKeyboard.KeyboardFunctionKeys.Language 语言功能键可见
  • QtVirtualKeyboard.KeyboardFunctionKeys.All 所有功能键可见

默认值为QtVirtualKeyboard.KeyboardFunctionKeys.All 。

该属性在 QtQuick.VirtualKeyboard.Settings 6.6 中引入。


wordCandidateList group

wordCandidateList.alwaysVisible : bool [since QtQuick.VirtualKeyboard.Settings 2.2]

wordCandidateList.autoHideDelay : int [since QtQuick.VirtualKeyboard.Settings 2.2]

名称名称
自动隐藏延迟该属性以毫秒为单位定义候选词列表隐藏（如果为空）的延迟时间。

如果值为0 ，则在清空时立即隐藏列表。

如果值为-1 ，则在输入焦点改变或输入面板隐藏之前，列表一直可见。

默认值为5000 毫秒。

始终可见该属性定义候选词列表是否始终保持可见。

默认值为false 。

自动提交单词此属性启用自动提交功能，该功能在候选词列表缩小到单个候选词时激活。

当单词候选列表最初包含多个单词，并在额外输入后缩减为单个单词时，自动提交功能生效。该单词将被自动选择并提交，无需用户交互。

该属性默认设置为false 。

此 QML 属性在 QtQuick.VirtualKeyboard.Settings 2.2 中引入。


信号文档

userDataReset()

应用程序在重置用户数据前触发此信号，以向虚拟键盘指示必须关闭用户数据目录中的所有文件。

注： 相应的处理程序是onUserDataReset 。


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.