用途:在 Windows Forms 应用中用 GridLayout 布局管理器,把多个子控件自动排列成行列网格,并精确控制间距。适合需要统一行列结构、动态增删布局控件的场景。
主要能力:提供网格结构(自动按行列排列)、间距控制(HGap 水平间距、VGap 垂直间距)、控件参与控制(ParticipateInLayout,可让某控件加入或退出布局)、动态配置行数与列数。关键属性包括 Rows(指定行数,设置后会决定列数)、Columns(在 Rows 为 null 或负值时生效)、HGap、VGap、ContainerControl(承载布局管理器的窗体或容器)。
使用方式:通过设计器或代码创建 GridLayout 实例,设置 ContainerControl 指向窗体,配置 Rows、Columns、HGap、VGap,再将子控件加入容器,并用 SetParticipateInLayout 指定控件是否参与布局。常用模式有单列纵向堆叠(Rows=null、Columns=1)、均匀间距的 3x3 网格(Rows=3、Columns=3、HGap=5、VGap=5),以及隐藏某控件但不移除(SetParticipateInLayout(control, false))。示例代码: using Syncfusion.Windows.Forms.Tools; GridLayout gridLayout1 = new GridLayout(); gridLayout1.ContainerControl = this; gridLayout1.Rows = 2; gridLayout1.Columns = 2; gridLayout1.HGap = 10; gridLayout1.VGap = 10; gridLayout1.SetParticipateInLayout(button1, true);
适用场景:WinForms 表单中多控件整齐排列、行列一致的界面布局、需要按条件动态显示或隐藏布局项。
限制:具体版本兼容性、NuGet 包名、许可与收费信息资料未提供;需安装 Syncfusion WinForms 相关程序集。