用途:GradientPanelExt 是 Windows Forms 标准 Panel 的增强控件,用于构建带渐变背景、圆角、边框基元与折叠/展开功能的容器面板,可承载其他 WinForms 控件。
主要能力:支持多种渐变样式(Horizontal、Vertical、ForwardDiagonal、BackwardDiagonal、PathRectangle、PathEllipse)、多色渐变、纯色与图案背景、背景图片;通过 CornerRadius 设置圆角,BorderGap 控制边框间距;Primitives 集合可在上、下、左、右边框放置文本(TextPrimitive)、图片(ImagePrimitive)、折叠按钮(CollapsePrimitive)或宿主控件(HostPrimitive);支持带动画的折叠/展开(Animated、AnimationDelay、AnimationSpeed)。
使用方式:需引用 Syncfusion.Shared.Base 程序集与 NuGet 包,命名空间为 Syncfusion.Windows.Forms.Tools 和 Syncfusion.Drawing。可通过 Visual Studio 设计器拖放或代码实例化。基本用法:创建 GradientPanelExt,设置 Size、Location,用 BrushInfo 配置 BackgroundColor(渐变样式与起止颜色),设置 CornerRadius,再通过 Controls.Add 添加子控件;边框元素通过 Primitives.AddRange 添加。
适用场景:登录/认证面板、仪表板分区、设置面板、信息框、向导步骤、分组控件、可折叠侧边栏等。
限制:CollapsePrimitive 需自行设置折叠与展开图片;动画属性仅在配合 CollapsePrimitive 时生效;Primitives 位于边框而非主面板区域;应避免过多基元以保证性能。具体安装命令、价格与平台支持资料暂未提供。