C

SafeText QML 类型

提供一个可以在 Qt 安全渲染器运行时渲染的 QML 文本类型。 更多...

导入语句import Qt.SafeRenderer 2.0

属性

详细说明

如果将 runtimeEditable 设置为 true,则可以在运行时更改 text。SafeText 对象将场景位置变化通知给 Safe Renderer 运行时。为此 purposes,必须设置唯一的 objectName 属性。

注意:如果字体大小大于 175,SafeText 将无法正确渲染。

以下代码提供了 SafeText 类型的示例

SafeText {
    id: safeText
    objectName: "safeText"
    x: 256
    y: 8
    text: "Safe text.."
    color: "black"
    fillColor: "white"  // optional, but recommended to use fillColor for controlled background color
    font.pixelSize: 12
}

属性文档

color : 颜色

此属性包含文本颜色。如果将 runtimeEditable 设置为 true,则可以在运行时更改此属性。

以下代码提供了使用十六进制记法定义的绿色文本的示例

SafeText {
    color: "#00FF00"
    text: "green text"
}

以下代码提供了使用 SVG 颜色名称定义的钢蓝色文本的示例

SafeText {
    color: "steelblue"
    text: "blue text"
}

fillColor : 颜色

此属性包含文本的背景填充颜色。如果将 runtimeEditable 设置为 true,则可以在运行时更改此属性。

以下代码提供了使用十六进制记法定义的蓝色文本背景的示例

SafeText {
    fillColor: "#0000FF"
    text: "text on blue background fill color"
}

以下代码提供了使用 SVG 颜色名称定义的钢蓝色文本背景的示例

SafeText {
    fillColor: "steelblue"
    text: "text on steelblue background fill color"
}

font.bold : 布尔值

此属性表示字体是否加粗。


font.italic : 布尔值

此属性表示字体是否有斜体样式。


font.pixelSize : 整型

此属性存储像素字体大小。

使用此属性使得字体取决于设备。


height : 实型

此属性存储文本的高度。默认值是 64


horizontalAlignment : 枚举

此属性存储文本在 SafeText 宽度内的水平对齐方式。水平对齐遵循文本的自然对齐方式。例如,从左到右阅读的文本将对齐到左侧。

horizontalAlignment 的有效值包括 SafeText.AlignLeftSafeText.AlignRightSafeText.AlignHCenterSafeText.AlignJustify


objectName : 字符串

此属性存储此特定对象实例的 QObject::objectName。


opacity : 实型

此属性存储项的不透明度。不透明度指定为介于 0.0(完全透明)和 1.0(完全不透明)之间的数字。默认值是 1.0。有关更多信息,请参阅 不透明度属性


runtimeEditable : 布尔型

此属性存储是否可以在运行时更改 textcolor。更改文本和颜色的操作需要通过 SafeRenderer::QSafeEventSetTextSafeRenderer::QSafeEventSetColor 事件完成。

当设置为 true 并构建 Qt Quick 项⽬时,将为项目中的每个动态 SafeText QML 类型使用的每种字体类型生成一个 .qpf2 文件。默认情况下,此设置为 false,将生成一个 .srb 文件。

当设置为 true 时,可以在运行时更改 textcolor


text : 字符串

此属性存储要显示的文本。如果 runtimeEditable 设置为 true,则可以在运行时进行更改。


verticalAlignment : 枚举

此属性存储文本在 SafeText 高度内的垂直对齐方式。垂直对齐遵循文本的自然对齐方式。

verticalAlignment 的有效值包括 SafeText.AlignTopSafeText.AlignBottomSafeText.AlignVCenter


width : 实型

此属性存储文本的宽度。默认值是 128


wrapMode : 枚举

此属性存储文本的换行方式。仅当设置了显式宽度时,文本才会进行换行。

  • SafeText.NoWrap(默认值)- 不执行换行。如果文本中包含不足的新行,则将抛出以下异常

    SafeRenderer::QSafeTextLayout::OutOfBounds。

  • SafeText.WordWrap - 仅在单词边界进行换行。如果单词过长,则将抛出异常。

    SafeRenderer::QSafeTextLayout::OutOfBounds。

    注意:Text.WordWrapruntimeEditable 设置为 true 时,在 SafeText 中不支持。

  • SafeText.WrapAnywhere - 换行可以在行中的任何位置进行,即使在单词中间也可以。
  • SafeText.Wrap - 如果可能,将在单词边界进行换行;否则将在行的适当位置进行换行,甚至可能在单词中间。

x : real

此属性保存文本位置的 x 坐标。


y : real

此属性保存文本位置的 y 坐标。


在某些 Qt 许可证下可用。
了解更多信息。