LayerCollector 是 2D 用户界面容器的基础类,它会渲染 GuiObject 后代,例如 ScreenGui。
为了提高性能,LayerCollector 的外观在一个以下事件发生时被缓存:
- 子女是添加到或从子女中移除。
- 子代的属性发生了变更。
- Class.LayerCollector 本身的属性会更改。
概要
属性
切换是否显示此 LayerCollector 。
决定每次玩家角色重生时,LayerCollector 是否重置(删除自己并重新克隆到玩家的 Class.PlayerGui )。
控制 GuiObject.ZIndex 在所有这 LayerCollector 的子代上的行为。
描述 UI 元素的实际屏幕位置,以像素计。
描述 UI 元素的实际屏幕旋转度。
描述 UI 元素的实际屏幕大小,以像素计。
设置为“真”时,本地化将被应用到此 GuiBase2d 和它的子代。
一个引用 LocalizationTable 用于应用自动本地化到此 GuiBase2d 和它的子代。
在下向方向中自定义游戏手柄选择行为。
在左向向选择游戏手柄的行为进行自定义。
自定义游戏手柄选择行为在正确的方向。
在上向方向中自定义游戏手柄选择行为。
允许自定义游戏手柄选择移动。
活动
继承自GuiBase2d的活动- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
在游戏手柄选择移动到,离开或更改连接的 GuiBase2d 或任何子对象。
属性
ResetOnSpawn
当设置为 false 和这个 LayerCollector 是直接子女的 StarterGui ,它只会在每个玩家的 1> Class.PlayerGui1> 中复制一次,并且在玩家的角色重生时不会被删除。
当设置为 true (默认) 或此 LayerCollector 是一个 间接 后裔后,它将在其玩家角色重生时复制到每个玩家的 1> Class.PlayerGui1> 中,当其角色重生时,它将自动销毁。
ZIndexBehavior
控制 GuiObject.ZIndex 在所有这 LayerCollector 的子代上的行为。
使用 Enum.ZIndexBehavior.Sibling (默认),子女总是会在父母上面渲染,而 ZIndex 用于决定单个 UI 对象的子女在各个子女上面会在哪个顺序上渲染。
Enum.ZIndexBehavior.Global 按照 ZIndex 排序所有后代,然后使用层级顺序打破 связь使用。结果, GuiObject 后代必须有一个值为至少父元素级高度相同的值,否则它们将在子父元素级下渲染。