Button、Container、Switch、Frame、Video

Button 的文本与指针、Container 的裁剪、Switch 的开合状态、Frame 展示的 Page，以及 Video 的播放。所有 Element 节点共通的规则见 Element

Button

Button 节点带 element:nl.button 引脚。Get Button Label 读取屏幕上显示的标签。Set Button Label 写入的标签在所有语言中都按写入的内容显示，优先于翻译键和 Blueprint Value，直到页面重新打开。Self 形态见 Button

Get Button Label

blueprint.element.button.getLabel · Pure

读取屏幕上显示的标签，使用玩家当前的语言

Set Button Label

blueprint.element.button.setLabel · Latent

设置按钮文本

Set Button Pointer

blueprint.element.button.setPointer · Latent

选择按钮的默认指针形态。它没有数据引脚——卡片使用和按钮 Appearance 检视器 Mouse 区一样的带图标下拉框

卡片字段

Get Button Variant

blueprint.element.button.getVariant · Pure

旧的按 id 读取。为已有图保留注册，创建浮窗中不再提供

Set Button Variant

blueprint.element.button.setVariant · Latent

旧的按 id 写入，同样隐藏。它没有 variantId 引脚——读的是保存下来的参数——而作者侧已经没有填这个参数的入口了。请改用按名称选 Variant 的 Set Element Variant

Container

Container 节点带 element:nl.container 引脚。Self 形态见 Container

Get Container Clip Content

blueprint.element.container.getClipContent · Pure

读取容器是否裁剪溢出内容

Set Container Clip Content

blueprint.element.container.setClipContent · Latent

设置容器是否裁剪溢出内容

Get Container Variant

blueprint.element.container.getVariant · Pure

旧的按 id 读取，出于和 Button 那一对相同的原因在创建浮窗中隐藏

Set Container Variant

blueprint.element.container.setVariant · Latent

旧的按 id 写入，在创建浮窗中隐藏。请改用 Set Element Variant

Switch

Switch 节点带 element:nl.switch 引脚。Self 形态见 Switch；Switch 的 visible / enabled 一对和同族的其它节点一起放在 Displayable

它们都不会派发 Switch 的 Changed、Turned On 或 Turned Off 事件头——那几个是留给玩家自己去拨的。一张既写又听同一个开关的图不会把自己触发起来

Get Switch Checked

blueprint.element.switch.getChecked · Pure

Set Switch Checked

blueprint.element.switch.setChecked · Latent

Turn Switch On

blueprint.element.switch.turnOn · Latent

传 true 的 Set Switch Checked，单独做成一张卡，好让最常见的那件事读起来就是一个词

Turn Switch Off

blueprint.element.switch.turnOff · Latent

Toggle Switch

blueprint.element.switch.toggle · Latent

翻转状态，并把翻成了什么交回来，于是它后面的分支不必再读一次

Frame

Frame 节点带 element:nl.frame 引脚，操作的是该 Frame 自己的目标 Page 和参数。把玩家带到另一个 Page 是另一回事，由 App 里的 Go Page 负责。Self 形态见 Frame

Get Frame Target Page

blueprint.element.frame.getTargetPage · Pure

读取目标 Page 的 surface id；Frame 没有目标时为空字符串

Set Frame Page

blueprint.element.frame.setTargetPage · Latent

把 Frame 切到另一个 Page。下拉框会过滤掉该 Frame 所在的 Page，以及直接或经由组件绕回到它的 Page。Element 形态是通过连入的 Element 节点找到这个 Frame 的，所以引用没接上时，下拉框列出全部 Page。切换后由 Frame 控件走它原有的进场/出场动画

卡片字段

所选 Page 声明了参数时，卡片会在 props 之前为每个参数长出一个输入，与 Frame 中的 Self 版本相同

Get Frame Params

blueprint.element.frame.getParams · Pure

读取传给被嵌入 Page 的参数 object

Set Frame Params

blueprint.element.frame.setParams · Latent

写入参数 object。非 object 值会归一为空 object

Video

Video 节点带有名为 video 的 element:nl.video 引脚，因此可以在页面上任何持有视频绑定的图中使用，例如视频旁边跳过按钮的蓝图。每个节点对连入的视频所做的，与 Video 中同名节点对自身视频所做的相同。视频的 Playback Ended（播放结束）位于视频控件自己的蓝图中。

Play Video

blueprint.element.video.play · Latent

开始播放视频，或从暂停处继续播放；视频已播完时从头重新播放。

Pause Video

blueprint.element.video.pause · Latent

在当前位置暂停视频。

Stop Video

blueprint.element.video.stop · Latent

暂停视频并回到视频开头。

Seek Video

blueprint.element.video.seek · Latent

把视频移到 time 处。正在播放的视频移到结尾时运行该视频的 Playback Ended。

Get Video Time

blueprint.element.video.getTime · Pure

视频当前的播放位置，为从视频开头计的秒数。画面上没有视频时为 0。

Get Video Duration

blueprint.element.video.getDuration · Pure

视频文件的时长，单位为秒。加载完成前为 0。

Is Video Playing

blueprint.element.video.isPlaying · Pure

视频正在播放时为 true。

Is Video Ended

blueprint.element.video.isEnded · Pure

视频播放到结尾后为 true，直到再次播放或移动位置。开启循环时始终为 false。

Set Video Volume

blueprint.element.video.setVolume · Latent

设置视频的音量，代替控件上设置的音量。

Set Video Muted

blueprint.element.video.setMuted · Latent

将视频设为静音或取消静音。

Set Video Loop

blueprint.element.video.setLoop · Latent

开启或关闭循环。

Set Video Speed

blueprint.element.video.setPlaybackRate · Latent

设置视频的播放速度，1 为正常速度。

Get Video Volume

blueprint.element.video.getVolume · Pure

视频的音量（0 到 1），不含玩家的音量设置。

Is Video Muted

blueprint.element.video.isMuted · Pure

视频处于静音时为 true。