组件/其他组件

EWatermark 水印

import EUI 1.0

示例与代码

水印

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Item { width: Math.min(640, parent.width) height: 260 EWatermark { zIndex: 9 rotate: -18 tileHeight: 72 tileWidth: 150 anchors.fill: parent gap: Qt.point(42, 30) offset: Qt.point(16, 10) content: ["EUI", qsTr("内部资料")] font: Qt.font({ "pixelSize": 15, "bold": true }) color: EPaletteManager.ThemePalette.fetchColorForStyle(EStyle.Primary) } }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

属性

属性说明取值与默认值

colorcolor

自定义颜色；透明值通常表示使用当前主题或语义配色。

默认值动态绑定

containerContentalias

内容插槽；直接在组件内部声明 QML 子对象。

默认值别名：containerHost.data

contentvar

水印文字，支持字符串或字符串数组。

文字或文字数组

默认值undefined

contentComponentComponent

自定义主体内容的 Component 插槽；null 使用默认内容。 委托上下文见本页示例。

默认值null

enabledbool

是否允许交互；false 时控件禁用。

默认值true

fontfont

字体配置，控制字体、字号及文字样式。

常用字段：
family、pixelSize、pointSize
bold、italic、weight
underline、strikeout
letterSpacing、wordSpacing

默认值Qt.font({ pixelSize: 16 })

fontGapreal

相邻内容、列、行或文字间距，单位为像素。

默认值0

gappoint

水印之间的横向和纵向间距。

字段：x, y

默认值Qt.point(100, 100)

heightreal

组件尺寸，单位为像素；可绑定父布局尺寸。

默认值implicitHeight

imageurl

空状态插图或水印图片的资源地址。

默认值""

offsetpoint

水印内容在横向和纵向的偏移。

字段：x, y

默认值Qt.point(0, 0)

rotatereal

水印旋转角度，单位为度。

默认值-22

textAlignstring

水印文字的水平对齐方式。

"left" / "center"
"right" / "start"
"end"

默认值"center"

textBaselinestring

水印文字的垂直基线。

"top" / "hanging"
"middle" / "alphabetic"
"ideographic" / "bottom"

默认值"middle"

tileHeightint

水印单元格宽高，单位为像素；0 时自动计算。

默认值100

tileWidthint

水印单元格宽高，单位为像素；0 时自动计算。

默认值180

visiblebool

是否显示组件。

默认值true

widthreal

组件尺寸，单位为像素；可绑定父布局尺寸。

默认值implicitWidth

zIndexint

浮层或水印的层叠顺序。

默认值9

columnCountint只读

数据行数或水印布局的列/行数量，由模型或布局计算。

默认值由运行时计算

effectiveGapXreal只读

水印实际水平或垂直间距，单位为像素。

默认值由运行时计算

effectiveGapYreal只读

水印实际水平或垂直间距，单位为像素。

默认值由运行时计算

effectiveTileHeightreal只读

水印根据内容或显式配置计算的实际单元格尺寸。

默认值由运行时计算

effectiveTileWidthreal只读

水印根据内容或显式配置计算的实际单元格尺寸。

默认值由运行时计算

hasContentbool只读

当前是否有可显示的自定义内容。

默认值由运行时计算

resolvedContentstring只读

水印最终显示的文字行数组。

默认值由运行时计算

rowCountint只读

数据行数或水印布局的列/行数量，由模型或布局计算。

默认值由运行时计算

stepXreal只读

水印铺排的水平或垂直步进距离。

默认值由运行时计算

stepYreal只读

水印铺排的水平或垂直步进距离。

默认值由运行时计算