GridBagLayout 是 Syncfusion Windows Forms 提供的布局管理器,用于在灵活虚拟网格中排布子控件。适合需要可变行列尺寸、控件跨多行多列、精细控制间距与对齐,以及复杂嵌套布局的场景,例如向导导航按钮、计算器按钮网格、对话框按钮面板和复杂表单。
主要能力:GridPostX/GridPostY 定位网格坐标;CellSpanX/CellSpanY 让控件跨多行多列;WeightX/WeightY 控制多余空间分配;Anchor 指定单元格内对齐,Fill(None、Both、Horizontal、Vertical)控制是否随空间缩放;Insets 设置控件四周内边距,IPadX/IPadY 调整首选尺寸。
使用方式:将 GridBagLayout 实例的 ContainerControl 设为容器,添加子控件,再通过 SetConstraints() 为每个控件设置 GridBagConstraints(依次为 gridPosX、gridPosY、cellSpanX、cellSpanY、weightX、weightY、anchor、fill、insets、iPadX、iPadY)。可用 GetConstraints()、GetConstraintsRef() 读取约束,GetLayoutWeights() 查看权重映射,也可在设计器中配置。
常见模式包括等分网格、控件跨列、非对称权重分配、仅锚定不填充。
限制:资料未提供收费、价格、平台或性能等细节,暂未提供。具体 API 行为以官方文档为准。