AtomUI/docs/Desktop.Controls/GroupBox/GroupBoxAPI.md

GroupBox API 参考

命名空间

namespace AtomUI.Desktop.Controls;

AXAML 命名空间前缀：atom（xmlns:atom="https://atomui.net"）

---

枚举类型

GroupBoxTitlePosition

标题位置枚举，控制标题在分组框顶部的水平对齐方式。

值	说明
Left	标题左对齐（默认）
Right	标题右对齐
Center	标题居中对齐

---

公共属性（StyledProperty）

属性名	类型	默认值	说明
HeaderTitle	string?	null	标题文本内容
HeaderTitleColor	IBrush?	由主题控制（ColorText）	标题文本颜色
HeaderIcon	PathIcon?	null	标题图标，使用 Ant Design 图标集
HeaderTitlePosition	GroupBoxTitlePosition	GroupBoxTitlePosition.Left	标题水平对齐位置
HeaderFontSize	double	由主题控制（FontSize）	标题字体大小
HeaderFontStyle	FontStyle	FontStyle.Normal	标题字体风格（Normal / Italic / Oblique）
HeaderFontWeight	FontWeight	FontWeight.Normal	标题字重

继承自 Avalonia.Controls.ContentControl 的常用属性

属性名	类型	默认值	说明
Content	object?	null	分组框内容，可以是任意控件或布局面板
ContentTemplate	IDataTemplate?	null	内容数据模板
Background	IBrush?	由主题控制（ColorBgContainer）	背景色（同时用于标题遮挡区域的填充色）
BorderBrush	IBrush?	由主题控制（ColorBorder）	边框颜色
BorderThickness	Thickness	由 Token 控制（BorderThickness）	边框粗细
CornerRadius	CornerRadius	由 Token 控制（BorderRadius）	圆角半径
Padding	Thickness	由 Token 控制（ContentPadding）	内容区域内间距
IsEnabled	bool	true	是否启用
Margin	Thickness	0	外间距

---

事件

GroupBox 没有定义自定义事件。可使用继承自 Control 的标准事件：

事件名	类型	说明
PointerEntered	EventHandler<PointerEventArgs>	指针进入控件区域
PointerExited	EventHandler<PointerEventArgs>	指针离开控件区域
PointerPressed	EventHandler<PointerPressedEventArgs>	指针按下
PointerReleased	EventHandler<PointerReleasedEventArgs>	指针释放

---

伪类（Pseudo-Classes）

GroupBox 没有定义自定义伪类。仅支持继承自基类的标准伪类：

伪类	触发条件
:pointerover	鼠标悬浮在 GroupBox 上
:disabled	IsEnabled == false
:focus	获得焦点
:focus-visible	通过键盘（Tab）获得焦点

---

实现的接口

GroupBox 没有实现 AtomUI 共享接口（如 ISizeTypeAware、IWaveSpiritAwareControl 等），因为它是一个静态容器控件，不需要尺寸切换、波纹效果等交互特性。

---

关键内部成员

以下成员为 private，不对外暴露，但有助于理解控件的工作原理：

成员	类型	说明
_borderRenderHelper	BorderRenderHelper	边框渲染辅助器，负责绘制带圆角的边框和背景
_headerContentContainer	Control?	标题内容容器引用（PART_HeaderContent），用于计算遮挡区域
_frame	Border?	主框架引用（PART_Frame），用于布局计算
_borderBounds	Rect	计算后的边框区域（从标题垂直中心到控件底部）