VirtualKeyboardSettings QML 类型

提供虚拟键盘的设置。 更多...

导入语句import QtQuick.VirtualKeyboard.Settings
自QtQuick.VirtualKeyboard 1.2

属性

信号

详细说明

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

请注意，设置仅在当前应用程序的生命周期内有效，即配置更改不是永久的。

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

Component.onCompleted: VirtualKeyboardSettings.styleName = "retro"

属性文档

activeLocales : 列表<字符串> [自QtQuick.VirtualKeyboard.Settings 2.0起]

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

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

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

此属性是在QtQuick.VirtualKeyboard.Settings 2.0中引入的。


availableLocales : 列表<字符串> [只读，自QtQuick.VirtualKeyboard.Settings 2.0起]

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

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

此属性是在QtQuick.VirtualKeyboard.Settings 2.0中引入的。


defaultDictionaryDisabled : 布尔型 [自QtQuick.VirtualKeyboard.Settings 6.1起]

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

此属性是在QtQuick.VirtualKeyboard.Settings 6.1中引入的。


defaultInputMethodDisabled : 布尔型 [自QtQuick.VirtualKeyboard.Settings 6.1起]

此属性禁用默认输入法。此设置的目的是可以用纯输入法覆盖默认输入法，禁用其功能。

此属性是在QtQuick.VirtualKeyboard.Settings 6.1中引入的。


fullScreenMode : 布尔型 [自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 : 布尔型 [自QtQuick.VirtualKeyboard.Settings 6.1起]

此属性允许禁用手写输入模式，如果系统另外提供。

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

此属性是在QtQuick.VirtualKeyboard.Settings 6.1中引入的。


hwrTimeoutForAlphabetic : 布尔型 [自QtQuick.VirtualKeyboard.Settings 6.1起]

此属性为字母语言设置手写识别超时。

默认超时为500毫秒。

此属性是在QtQuick.VirtualKeyboard.Settings 6.1中引入的。


hwrTimeoutForCjk : 布尔型 [自QtQuick.VirtualKeyboard.Settings 6.1起]

此属性为中文/日文/韩文语言设置手写识别超时。

默认超时为500毫秒。

此属性是在QtQuick.VirtualKeyboard.Settings 6.1中引入的。


inputMethodHints : 整数 [自QtQuick.VirtualKeyboard.Settings 6.1起]

此属性允许设置持久输入法提示。

此属性值与输入控件输入法提示组合。例如，要禁用文本预测输入，则此属性可以设置为 Qt::ImhNoPredictiveText。

此属性是在QtQuick.VirtualKeyboard.Settings 6.1中引入的。


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

此属性提供键盘的默认区域设置。

当未指定区域设置时，将使用默认系统区域设置。

如果键盘区域设置与新的默认区域设置不同，则键盘语言将立即更改以反映新的区域设置。如果区域设置不正确，或者它不在支持的区域设置列表中，则忽略它并使用默认设置。

如果它包含在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 组

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

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

名称描述
autoHideDelay此属性定义在词候选列表为空后，在多少毫秒后隐藏。

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

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

默认值是5000毫秒。

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

默认值是false。

autoCommitWord此属性启动自动提交功能，当词候选列表减少到单个候选时激活。

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

默认情况下，此属性设置为 false。

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


信号文档

userDataReset()

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

注意：相应的处理程序为 onUserDataReset。


© 2024 Qt公司有限公司。本文档中包含的文档贡献是各自所有者的版权。本提供的文档是根据自由软件基金会发布、版本1.3的GNU自由文档许可协议条款授予的。Qt及其相应标志是芬兰以及全球其他国家的Qt公司有限公司的商标。所有其他商标均为其各自所有者的财产。