# 用户属性介绍

Wallpaper Engine可以让你通过将用户属性添加到项目中,使壁纸的某些部分可由用户自行配置。当用户在已安装选项卡中选择壁纸时,这些用户属性将显示在右侧。在本指南中,我们将解释如何创建和使用属性以及每种属性类型所代表的内容。高级用户还可以将用户属性集成到 SceneScript 代码中,这将在文档的 SceneScript部分中进行了说明。

# 用户属性

Wallpaper Engine支持以下几种用户属性类型。单击其中任何一个以查看有关其工作原理的详细说明:

  • 颜色 (color):颜色选择器
  • 滑块 (slider):滑块可以让用户在指定范围内选择一个数字。
  • 复选框 (bool):打开或关闭的复选框
  • 组合框 (combo):一个下拉选择器,其中每个元素都有一个文本和一个隐藏值
  • 文本框 (textinput):输入文本字段。
  • 纹理 (texture):允许用户将纹理替换为自定的图片或视频。

选中壁纸后,用户属性将显示在右侧:

User Properties

你可以随时查看、编辑、创建新属性,方式是:在Wallpaper Engine编辑器中,点击顶部的编辑菜单并选择更改项目设置

# 创建具有显示条件的子属性

在某些情况下,你可能希望在某些条件下显示或隐藏其他属性。例如,以我们在上一节中使用的示例为例:你有一个可见性的时钟,每当启用时钟时,你都希望向用户显示一个额外的选项,以便在 24 小时和 12 小时格式之间切换。这有助于整理属性列表,让你可以在需要时有选择地显示属性。这样的话,你就可以创建两个复选框属性:

  • 显示时钟
  • 使用 24 小时格式

对于时钟,你可以在时钟的属性中找到使用24小时格式的属性。类似于上一示例中的操作,为它创建新的复选框用户属性。然而在这种情况下,你需要获取该用户属性的关键字,并在条件输入框中写入一行代码。别担心,它不是很复杂。我们创建的时钟属性的关键字是show_clock —— 你可以在属性列表中查找每个属性的关键字。我们现在希望显示条件为:

show_clock.value == true

如果时钟不可见,使用24小时格式用户属性将没有意义,你最好将其隐藏。这可以显著减少壁纸设置的混乱,使用户更容易配置壁纸。

为了实现这一点,首选创建一个复选框属性Show Clock(或者你想使用的任何属性名称)。在下面的代码中,Wallpaper Engine会自动生成 关键字 show_clock。在这个例子中,*"Show Clock"*对应的关键字是show_clock

现在,创建你的相关用户属性。在创建时,你可以在底部配置显示条件,你只需要在这里添加以下代码(只需将show_clock替换为你的关键字):

show_clock.value == true

你可以观看下面的视频了解整个过程:

提示

你还可以使用组合框属性创建显示条件。在这种情况下,你需要将关键字替换为在组合框属性中创建的值。例如:

yourproperty.value == "example123"