MRTK Scrolling Object Collection渲染异常及裁剪问题咨询

问题1：列表项图标忽略Button Config Helper设置 #

• 先确认Button Config Helper的Apply On Awake是否勾选。如果没开，GridObjectCollection完成布局的时机可能早于按钮初始化，导致Sprite设置没生效。要么勾选这个选项，要么在代码里遍历Grid的子按钮，手动调用ButtonConfigHelper.Apply()方法。
• 检查GridObjectCollection的布局执行顺序。如果Grid的布局刷新覆盖了Button的配置，就在Grid的OnPostLayout()事件里，强制触发所有子按钮的ButtonConfigHelper刷新。
• 核对Button Config Helper的Icon Target字段，确保它指向按钮预制体里正确的图标组件（默认是ButtonVisuals/Icon下的Image）。如果你的自定义图标替换了默认组件，必须重新指定这个目标。

问题2：滚动时自定义图标超出裁剪框 #

• 检查Scrolling Object Collection的Clipping组件：确保Clipping Mode设为Soft Clip或Hard Clip，且Clip Target指向滚动容器的根物体（所有列表项的父物体）。
• 确认自定义图标的渲染组件（Image/SpriteRenderer）的Maskable属性已启用。如果用的是SpriteRenderer，必须使用MRTK自带的支持裁剪的UI材质，不要用不兼容的自定义材质。
• 给图标所在的GameObject添加ClippingBehaviour组件，并关联到Scrolling Object Collection的Clipping组件——MRTK 2.6.1里SpriteRenderer的裁剪需要额外绑定这个组件才能生效。
• 打开Clipping组件的Gizmo可视化裁剪区域，在Scene视图里确认图标是否真的超出范围，还是渲染层级导致的视觉穿透。

快速排查步骤 #

1. 在编辑器里选中GridObjectCollection，点击Update Collection按钮，看图标是否恢复，判断是不是布局时机问题。
2. 手动禁用/启用一个列表项的Button Config Helper，观察图标变化，确认组件是否正常工作。

内容的提问来源于stack exchange，提问作者Eduardo Corona