在 Avalonia 中创建无边框但可拖动的窗口,关键在于禁用默认窗口装饰,并通过指定区域(如标题栏)启用拖动行为。Avalonia 本身不提供像 WPF 的
DragMove()那样直接的方法,但可通过
BeginMoveDrag手动触发窗口拖动。
设置窗口为无边框
在 XAML 中将
Window的
WindowStyle设为
None,并关闭系统菜单和最大化/最小化按钮:
<Window xmlns="https://github.com/avaloniaui"
WindowStyle="None"
CanResize="True"
MinWidth="400" MinHeight="300"
ExtendClientAreaToDecorationsHint="True">
ExtendClientAreaToDecorationsHint="True"允许自定义标题栏区域“接管”系统装饰区,是实现拖动的前提之一。
添加可拖动区域(例如自定义标题栏)
在窗口顶部添加一个
Panel(如
Grid或
Border),并为其绑定鼠标事件:
<Grid Name="TitleBar" Background="Transparent" Height="32">
<TextBlock HorizontalAlignment="Center" VerticalAlignment="Center">我的应用</TextBlock>
</Grid>
然后在代码后台(如
MainWindow.xaml.cs)中订阅
PointerPressed事件:
public MainWindow()
{
InitializeComponent();
TitleBar.PointerPressed += OnTitleBarPointerPressed;
}
private void OnTitleBarPointerPressed(object? sender, PointerPressedEventArgs e)
{
if (e.GetCurrentPoint(this).Properties.IsLeftButtonPressed)
BeginMoveDrag(e);
}
确保拖动仅响应左键且不干扰其他操作
注意以下几点避免误触发:
务必检查e.GetCurrentPoint(this).Properties.IsLeftButtonPressed,防止右键或中键触发拖动 拖动区域(如
TitleBar)背景不能为
Null,建议设为
Transparent;否则鼠标事件可能不冒泡 若使用
Button等控件作为标题栏内容,需设置
IsHitTestVisible="False",避免拦截鼠标事件
适配多显示器与 DPI 缩放
Avalonia 的
BeginMoveDrag默认已适配高 DPI 和多屏场景,无需额外处理。但需确保窗口未被设为
Topmost="True"(否则拖动可能异常),且
CanResize="True"开启以支持后续调整大小(如需要)。
