WPF 中的 GridSplitter 详解

1. 什么是 GridSplitter?

GridSplitter 是 WPF 提供的一个控件,用于调整 Grid 布局的行或列的大小。它可以让用户在运行时拖动分隔线,以改变相邻的行或列的大小,而不需要修改 XAML 代码。


2. GridSplitter 的基本用法

(1)水平分割(调整行高度)

如果希望 GridSplitter 在 水平方向 调整行的大小,必须将其放在一行,并确保该行的 Height 设为 Auto,这样 GridSplitter 才能自由调整。

解释:

  • GridSplitter 放在 第二行 (Grid.Row="1")。

  • Height="5" 设定分割线的厚度。

  • HorizontalAlignment="Stretch" 让 GridSplitter 占满网格的宽度。


(2)垂直分割(调整列宽度)

如果希望 GridSplitter 在 垂直方向 调整列的大小,必须将其放在一列,并确保该列的 Width 设为 Auto。

解释:

  • GridSplitter 放在 第二列 (Grid.Column="1")。

  • Width="5" 设定分割线的厚度。

  • VerticalAlignment="Stretch" 让 GridSplitter 占满网格的高度。


3. GridSplitter 的属性

(1)主要属性

属性 说明
Width / Height 控制 GridSplitter 的厚度(水平或垂直)。
Background 设定 GridSplitter 的背景颜色,方便用户看到。
HorizontalAlignment 适用于 水平 GridSplitter,通常设为 Stretch。
VerticalAlignment 适用于 垂直 GridSplitter,通常设为 Stretch。
ResizeDirection 控制调整 行 还是 列 ,默认为 Auto。
ResizeBehavior 控制如何调整大小,如 PreviousAndNext(默认)、Previous、Next。
DragIncrement 设置拖动时的最小步长,默认值为 1,单位是像素。

(2)ResizeDirection(调整方向)

|------------|------------------------------------|
| 选项 | 说明 |
| Auto(默认) | 自动检测 GridSplitter 的方向(垂直或水平)。 |
| Columns | 只调整 列宽 (适用于垂直 GridSplitter)。 |
| Rows | 只调整 行高 (适用于水平 GridSplitter)。 |

示例:

(3)ResizeBehavior(调整行为)

|-----------------------|-----------------------------------|
| 选项 | 说明 |
| PreviousAndNext(默认) | 调整 GridSplitter 前后 两侧的行或列。 |
| Previous | 只调整 GridSplitter 前一行/列 的大小。 |
| Next | 只调整 GridSplitter 后一行/列 的大小。 |

示例:


4. 进阶使用:结合 MinHeight / MinWidth

在调整大小时,可以限制最小高度或最小宽度,防止拖动过度导致 UI 变形。


5. 总结

|------------|--------------------------------------------------------------------------------------------------|
| 功能 | 方法 |
| 调整行高 | GridSplitter 放在 RowDefinition Height="Auto" 行内,Height="5",HorizontalAlignment="Stretch"。 |
| 调整列宽 | GridSplitter 放在 ColumnDefinition Width="Auto" 列内,Width="5",VerticalAlignment="Stretch"。 |
| 限制拖动范围 | 设定 MinHeight / MinWidth 防止过度拖动。 |
| 控制调整方式 | 使用 ResizeDirection(Rows/Columns)和 ResizeBehavior(PreviousAndNext)。 |
| 设置拖动步长 | DragIncrement="10" 控制拖动时最小步长,提高调整体验。 |

GridSplitter 是 WPF 进行 动态 UI 布局 的重要工具,正确使用可以提升用户体验,使界面更加灵活。

相关推荐
zdr尽职尽责2 小时前
UnityCli 兼容2022版本
ui·unity·ai·c#·游戏引擎
BruceNeter1 天前
C# winform卡死问题分析1——线程池子线程创建句柄
c#·.net
samble2 天前
从零搭建半导体设备上位机(十二):参数设置页,表单校验、范围校验与配方联动
wpf·数据校验·validationrule
何以解忧唯有撸码3 天前
开源】当桌面图标开始打台球:我用 WinForms 做了一桌“真的”台球
c#·winform·自定义控件·gdi
国家一级摸鱼选手3 天前
[Unity]几何碰撞检测:SAT 分离轴定理详解(从数学原理到 C# 实现)
unity·c#·游戏引擎·分离轴定理(sat)·多边形相交
汤姆宝库4 天前
BPE分词器的完整实现:字节对合并与词表构建
开发语言·人工智能·c#
Risehuxyc4 天前
C# 发展历史
开发语言·c#
kyle~4 天前
C# --- 反射
开发语言·c#
暴走约伯5 天前
【VFX工具链源码拆解 09】终极工业化闭环:基于 ID 规则驱动的全自动场景建档、骨骼挂载与男转女场景迁移
unity·c#·游戏引擎·材质
用户788477316346 天前
WinForms 迁移 WPF:Upgrade Assistant 覆盖 30%,剩下 70% 我手写了六周
c#