用途:SplitContainerAdv 是一个容器控件,用于在 Windows Forms 应用中创建由可移动分隔条隔开的双面板可调整布局,适合需要灵活划分窗体的场景。
主要能力:包含 Panel1 与 Panel2 两个可调整面板,支持水平或垂直方向;支持面板折叠与展开;可定制分隔条外观(缩略箭头、抓手、悬停状态);支持嵌套容器(SplitContainerAdv 内嵌 SplitContainerAdv);提供分隔条移动事件,并带有可视化样式选项。
使用方式:可经设计器或代码添加控件。基本做法是创建 SplitContainerAdv,设置 Dock = DockStyle.Fill、Orientation 与 SplitterDistance,再向 Panel1、Panel2 的 Controls 添加子控件,最后加入窗体。常见模式包括固定一侧面板(FixedPanel)、可折叠面板(PanelToBeCollapsed 配合 TogglePanelOn)、垂直等分布局(用 Height/2 设置 SplitterDistance 并设最小尺寸)。
关键属性:Orientation、SplitterDistance、FixedPanel、Panel1Collapsed、Panel2Collapsed、IsSplitterFixed、SplitterWidth、Panel1MinSize、Panel2MinSize,以及外观相关的 ExpandFill、HotGripDark。事件包括 SplitterMoved 与 SplitterMoving,可用于阻止分隔条移动等交互控制。文档导航涵盖入门、面板配置、分隔条定制、外观样式、事件处理等参考章节。
适用场景:需要在窗体中提供可调整的分栏布局,如侧边栏与主内容区、工具栏固定区域、上下或左右分栏,以及复杂的嵌套布局。
限制:资料未提供具体版本、授权与收费信息,亦未给出完整平台兼容范围或性能说明,这些内容暂未提供。示例代码仅用于说明控件配置方式。