kwgt 中文文档 下载 App

kwgt Root 层与全局属性 画布级设置

Root 层是什么

Root 是 Items 面板最顶端的条目——它代表整个画布本身。任何在 Root 层设的属性都会被所有子元素继承,除非子元素自己显式覆盖了。

简单理解:Root 层是"全局默认值",子元素可以有自己的偏好。

Root 层常用设置

画布背景

在 Root 层的 Paint 标签页里:

全局缩放 Scale

Root 的 Scale 可以一次性把画布上所有元素等比例放大或缩小。当你觉得整体设计太小或太大时,调 Root Scale 比重叠改每个元素的 Scale 高效得多。

画布偏移

Root 的 Position 可以把整个画布内容相对桌面做整体偏移。适用于:

画布宽高与圆角

Root 层还可以设置小组件画布本身的圆角、边框、是否裁剪内容。圆角设大了之后,小组件的四角会被圆掉,露出桌面壁纸。

子元素覆盖 Root 属性

举个例子:

  1. 在 Root 层把 Paint Color 设成蓝色 → 所有子元素默认都是蓝色
  2. 选中某个文字元素,在它自己的 Paint 里改颜色为红色 → 只有它是红色,其他元素还是蓝色

这就是继承 + 局部覆盖的逻辑。

什么时候改 Root 层 vs 改子元素

场景改哪里
想给整个画布加一个背景色 / 背景图Root
想整体把所有元素放大 1.2 倍Root
想把某一个文字改成红色该文字元素自己的 Paint
想让某个形状有单独的触摸事件该形状元素自己的 Touch
想给整个画布加一个时间驱动的颜色渐变Root 的 Paint + if 函数