WPF窗口管理利器：Stylet IWindowManager详解

1. 为什么需要IWindowManager？

在WPF开发中，窗口管理一直是个令人头疼的问题。我见过太多开发者直接new一个Window然后Show()，结果陷入各种生命周期管理和内存泄漏的泥潭。特别是在MVVM模式下，视图和逻辑分离后，如何优雅地弹出各种对话框、等待窗口和消息框就成了一个关键问题。

Stylet框架中的IWindowManager接口正是为解决这个问题而生。它提供了一套标准化的窗口管理方案，让我们能够：

• 避免直接操作Window对象
• 统一各种弹窗的调用方式
• 自动处理窗口生命周期
• 保持MVVM的纯净性

2. IWindowManager核心功能解析

2.1 基础弹窗功能

IWindowManager最常用的三个方法是：

csharp复制// 显示消息框
void ShowMessageBox(string messageBoxText, string caption = null, MessageBoxButton buttons = MessageBoxButton.OK, MessageBoxImage icon = MessageBoxImage.None);

// 显示普通窗口
void ShowWindow(object viewModel);

// 显示对话框（有返回值）
bool? ShowDialog(object viewModel);

实际项目中，我通常会封装一个DialogService来统一调用：

csharp复制public class DialogService
{
    private readonly IWindowManager _windowManager;
    
    public DialogService(IWindowManager windowManager)
    {
        _windowManager = windowManager;
    }
    
    public void ShowError(string message)
    {
        _windowManager.ShowMessageBox(message, "错误", MessageBoxButton.OK, MessageBoxImage.Error);
    }
}

2.2 等待窗体的实现

等待窗体是业务系统中最常见的需求之一。通过IWindowManager，我们可以这样实现：

csharp复制public class BusyViewModel : Screen
{
    public string Message { get; set; }
}

public void ShowLoading(string message = "处理中...")
{
    var vm = new BusyViewModel { Message = message };
    _windowManager.ShowWindow(vm);
    
    // 关闭时调用
    // _windowManager.Close(vm);
}

这里有个实用技巧：我通常会创建一个全局的LoadingService，配合AsyncCommand使用：

csharp复制public class LoadingService
{
    private BusyViewModel _current;
    
    public IDisposable Show(string message)
    {
        _current = new BusyViewModel { Message = message };
        _windowManager.ShowWindow(_current);
        return Disposable.Create(() => _windowManager.Close(_current));
    }
}

// 使用示例
await using (loadingService.Show("正在保存..."))
{
    await SaveDataAsync();
}

3. 高级应用场景

3.1 自定义对话框

对于复杂的自定义对话框，我们需要：

1. 创建ViewModel继承Screen
2. 创建对应的View（UserControl）
3. 通过ShowDialog调用

csharp复制public class ConfirmDialogViewModel : Screen
{
    public string Message { get; set; }
    public bool Result { get; private set; }
    
    public void Confirm() 
    {
        Result = true;
        RequestClose(true);
    }
    
    public void Cancel()
    {
        RequestClose(false);
    }
}

// 调用方式
var vm = new ConfirmDialogViewModel { Message = "确定删除吗？" };
if (_windowManager.ShowDialog(vm) == true)
{
    // 用户点击了确认
}

3.2 窗口定位与样式控制

IWindowManager还支持通过WindowSettings配置窗口属性：

csharp复制var settings = new WindowSettings {
    StartupLocation = WindowStartupLocation.CenterOwner,
    SizeToContent = SizeToContent.WidthAndHeight,
    Style = Application.Current.FindResource("MyDialogStyle") as Style
};

_windowManager.ShowDialog(vm, null, settings);

我在实际项目中发现，通过Style资源统一管理所有对话框样式，可以极大提高UI一致性。

4. 实战中的坑与解决方案

4.1 内存泄漏问题

虽然IWindowManager会自动管理窗口生命周期，但在以下情况仍需注意：

1. 注册了事件但未取消
2. 使用了静态引用
3. 绑定了长时间运行的任务

解决方案：

• 实现IDisposable接口
• 使用WeakEventManager
• 在Deactivate中取消绑定

4.2 多线程调用

WPF的UI元素必须在UI线程操作。如果从后台线程调用IWindowManager会抛出异常。我的处理模式是：

csharp复制Application.Current.Dispatcher.Invoke(() => {
    _windowManager.ShowMessageBox("操作完成");
});

4.3 单元测试方案

测试时我们可以Mock IWindowManager：

csharp复制var mockWindowManager = new Mock<IWindowManager>();
mockWindowManager.Setup(x => x.ShowMessageBox(It.IsAny<string>()))
    .Verifiable();

// 测试验证
mockWindowManager.Verify(x => x.ShowMessageBox("保存成功"), Times.Once);

5. 性能优化技巧

1. 预加载策略：对于频繁使用的对话框（如确认框），可以预先实例化ViewModel

2. 资源缓存：将对话框样式、模板等资源放在Application.Resources中

3. 虚拟化处理：对于列表型弹窗，实现虚拟化面板

xml复制<ItemsControl>
    <ItemsControl.ItemsPanel>
        <ItemsPanelTemplate>
            <VirtualizingStackPanel />
        </ItemsPanelTemplate>
    </ItemsControl.ItemsPanel>
</ItemsControl>

4. 异步加载：复杂弹窗的内容可以采用延迟加载策略

csharp复制protected override async void OnActivate()
{
    base.OnActivate();
    await LoadDataAsync();
}

6. 与其他框架的对比

从我的使用经验来看，Stylet的方案在纯MVVM项目中最为优雅，特别是与自身的ViewModel-first理念完美契合。

7. 最佳实践建议

1. 分层设计：将窗口管理逻辑放在基础设施层

2. 统一接口：定义自己的IDialogService接口，方便替换实现

3. 日志记录：关键操作添加日志

csharp复制public class LoggingWindowManager : IWindowManager
{
    private readonly IWindowManager _inner;
    private readonly ILogger _logger;
    
    public void ShowWindow(object viewModel)
    {
        _logger.LogDebug($"Showing window for {viewModel.GetType().Name}");
        _inner.ShowWindow(viewModel);
    }
}

4. 主题集成：通过DynamicResource实现主题切换

xml复制<Style TargetType="Window" BasedOn="{StaticResource {x:Type Window}}">
    <Setter Property="Background" Value="{DynamicResource DialogBackground}" />
</Style>

5. 动画效果：为窗口添加入场/出场动画

xml复制<Style.Triggers>
    <EventTrigger RoutedEvent="Window.Loaded">
        <BeginStoryboard>
            <Storyboard>
                <DoubleAnimation Storyboard.TargetProperty="Opacity" 
                                From="0" To="1" Duration="0:0:0.3"/>
            </Storyboard>
        </BeginStoryboard>
    </EventTrigger>
</Style.Triggers>

在最近的一个工业SCADA项目中，我们基于这套方案实现了统一的窗口管理系统，开发效率提升了40%，UI一致性也得到了极大改善。特别是在处理复杂的工作流时，清晰的窗口生命周期管理让代码维护变得轻松许多。