C
SafeText QML 类型
提供一个可以在 Qt 安全渲染器运行时渲染的 QML 文本类型。 更多...
导入语句 | import Qt.SafeRenderer 2.0 |
属性
- color : 颜色
- fillColor : 颜色
- font.bold : 布尔值
- font.italic : 布尔值
- font.pixelSize : 整数
- height : 实数
- horizontalAlignment : 枚举
- objectName : 字符串
- opacity : 实数
- runtimeEditable : 布尔值
- text : 字符串
- verticalAlignment : 枚举
- width : 实数
- wrapMode : 枚举
- x : 实数
- y : 实数
详细说明
如果将 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 }
属性文档
此属性包含文本颜色。如果将 runtimeEditable 设置为 true
,则可以在运行时更改此属性。
以下代码提供了使用十六进制记法定义的绿色文本的示例
SafeText { color: "#00FF00" text: "green text" }
以下代码提供了使用 SVG 颜色名称定义的钢蓝色文本的示例
SafeText { color: "steelblue" text: "blue text" }
此属性包含文本的背景填充颜色。如果将 runtimeEditable 设置为 true
,则可以在运行时更改此属性。
以下代码提供了使用十六进制记法定义的蓝色文本背景的示例
SafeText { fillColor: "#0000FF" text: "text on blue background fill color" }
以下代码提供了使用 SVG 颜色名称定义的钢蓝色文本背景的示例
SafeText { fillColor: "steelblue" text: "text on steelblue background fill color" }
此属性存储文本在 SafeText 宽度内的水平对齐方式。水平对齐遵循文本的自然对齐方式。例如,从左到右阅读的文本将对齐到左侧。
horizontalAlignment
的有效值包括 SafeText.AlignLeft
、SafeText.AlignRight
、SafeText.AlignHCenter
和 SafeText.AlignJustify
。
此属性存储项的不透明度。不透明度指定为介于 0.0(完全透明)和 1.0(完全不透明)之间的数字。默认值是 1.0。有关更多信息,请参阅 不透明度属性。
此属性存储是否可以在运行时更改 text 和 color。更改文本和颜色的操作需要通过 SafeRenderer::QSafeEventSetText 和 SafeRenderer::QSafeEventSetColor 事件完成。
当设置为 true
并构建 Qt Quick 项⽬时,将为项目中的每个动态 SafeText QML 类型使用的每种字体类型生成一个 .qpf2 文件。默认情况下,此设置为 false
,将生成一个 .srb 文件。
此属性存储要显示的文本。如果 runtimeEditable 设置为 true
,则可以在运行时进行更改。
此属性存储文本在 SafeText 高度内的垂直对齐方式。垂直对齐遵循文本的自然对齐方式。
verticalAlignment
的有效值包括 SafeText.AlignTop
、SafeText.AlignBottom
和 SafeText.AlignVCenter
。
此属性存储文本的换行方式。仅当设置了显式宽度时,文本才会进行换行。
SafeText.NoWrap
(默认值)- 不执行换行。如果文本中包含不足的新行,则将抛出以下异常SafeRenderer::QSafeTextLayout::OutOfBounds。
SafeText.WordWrap
- 仅在单词边界进行换行。如果单词过长,则将抛出异常。SafeRenderer::QSafeTextLayout::OutOfBounds。
注意:
Text.WordWrap
当runtimeEditable 设置为true
时,在 SafeText 中不支持。SafeText.WrapAnywhere
- 换行可以在行中的任何位置进行,即使在单词中间也可以。SafeText.Wrap
- 如果可能,将在单词边界进行换行;否则将在行的适当位置进行换行,甚至可能在单词中间。
在某些 Qt 许可证下可用。
了解更多信息。