跳转到正文

UI 组件参考

查阅 Generic UI System 的按钮、选项卡、列表、Widget Factory 与细节视图组件及当前 API。

创建时间: 2025年4月15日更新时间: 2026年10月27日

范围

本页介绍 GenericUISystem 的代码组件。插件本体不包含 Widget 蓝图;具体外观、布局和数据适配由项目提供。配套项目内容与示例资产介绍可检查的项目示例。

按钮和选项卡

GUIS_ButtonBase 可作为项目按钮的基础;GUIS_TabButtonBase 实现 GUIS_TabButtonInterface。项目可派生自己的按钮 Widget。选项卡使用 GUIS_TabListWidgetBase 和 FGUIS_TabDescriptor:描述符包含唯一的 TabId、TabText、IconBrush、按钮类和可选内容类。按钮类需要实现 GUIS_TabButtonInterface。

在选项卡列表中配置预注册的描述符,或使用 RegisterDynamicTab 动态注册;将列表与项目的 Widget Switcher 关联后测试切换。旧版 GUIS_TabDefinition 与 TabDefinitions 已弃用,请以当前描述符和 PreregisteredTabInfoArray 为准。旧截图中的 GGF 名称和项目蓝图仅作历史示例。

列表与细节视图

GUIS_ListView 和 GUIS_TileView 支持通过 GUIS_WidgetFactory 根据数据对象选择条目 Widget。项目应实现工厂的选择逻辑并提供所需条目类。

GUIS_ListEntryDetailView、GUIS_ListEntryDetailSection 与 GUIS_DetailSectionsBuilder 可把一个数据对象的不同信息拆成多个 Section。为对象配置合适的 Builder 和项目 Widget,再按所需顺序展示。

提示

Item通常会是一个ListView中的ListEntryWidget所展示的对象,但也可以不是。

选项卡示意

下图展示旧项目布局,字段与类名以本页当前 API 为准。