【C#】 DevExpress.XtraEditors.SidePanel

DevExpress.XtraEditors.SidePanel，
它是 DevExpress 提供的“侧边滑出”面板（类似于抽屉、浮动信息区），非常适合做可隐藏的参数区、帮助区、临时交互区等。

---

SidePanel 用法核心点

1. 基本用法

• 可容纳其它控件，就像普通的Panel一样；
• 支持动画滑出/隐藏，可手动或代码控制其“出现/收回”；
• 可固定在父控件的上下左右四边。

---

2. 常用属性说明

• Dock
  设置为 Left/Right/Top/Bottom，即吸附到父容器某一边。一般做抽屉效果推荐Right或Left。
• Visible
  控制是否显示（可代码随时隐藏/显示）。
• AllowResize
  允许用户拖动改变SidePanel宽高（默认True）。

---

3. 典型使用场景

• 作为高级设置、详细信息、历史记录的浮出式侧栏。
• 当需要时动画滑出，不需要时隐藏，主界面更清爽。
• 可在按钮、菜单或自动触发时弹出（比如“参数详情”/“结果分析”）。

---

4. 代码控制 SidePanel 的显示与隐藏

// 显示
sidePanel1.Visible = true;// 隐藏
sidePanel1.Visible = false;// 切换（常用于按钮点击）
sidePanel1.Visible = !sidePanel1.Visible;

---

5. 设置动画（可选）

有些DevExpress版本支持动画：

sidePanel1.Show();
sidePanel1.Hide();

有的版本Show()/Hide()方法自带动画，如果没有可用Visible = true/false。

---

6. Dock 布局建议

• 让 sidePanel1 Dock=Right 或 Dock=Left，
  它会自动占据父容器的右（或左）侧，且弹出/收回时不会影响主内容布局。

---

7. 在设计器里怎么用？

1. 拖一个 SidePanel 到你的主界面；
2. 设置 Dock 到你想要的边（一般Right/Left）；
3. 拖你需要的控件（Label、Button等）到SidePanel里；
4. 需要显示/隐藏时，代码控制sidePanel1.Visible = true/false即可；
5. 可以用按钮、菜单等触发 SidePanel 的出现/隐藏。

---

实际例子

场景1：右侧滑出参数详情

// 点击“高级参数”按钮
private void btnAdvancedParams_Click(object sender, EventArgs e)
{sidePanel1.Visible = !sidePanel1.Visible;
}

• 用户点击按钮，sidePanel1右侧滑出显示参数；
• 再次点击按钮（或点sidePanel里“关闭”按钮），sidePanel1隐藏。

---

一句话总结

DevExpress SidePanel 是用于实现可动态显示/隐藏的侧边面板（抽屉），支持Dock到父容器四边，代码里用 Visible 控制即可，非常适合弹性参数区和信息区。

---