.NET MAUI Windows平台设置最小窗口尺寸遇CS0117错误求助

错误原因 #

你遇到的CS0117错误是因为.NET MAUI的WindowHandler类不存在WindowMapper静态成员，早期版本的MAUI API已变更，当前正确的映射配置需使用Mapper属性。

正确实现方案 #

以下是针对Windows平台设置窗口最小宽高的两种有效实现方式：

方式一：在App.xaml.cs中配置窗口处理器 #

using Microsoft.Maui.Platform;
using WinRT.Interop;

public App()
{
    InitializeComponent();

#if WINDOWS
    // 配置WindowHandler的映射逻辑
    Microsoft.Maui.Handlers.WindowHandler.Mapper.AppendToMapping(nameof(IWindow), (handler, view) =>
    {
        var nativeWindow = handler.NativeView as MauiWinUIWindow;
        if (nativeWindow == null) return;

        IntPtr hwnd = WindowNative.GetWindowHandle(nativeWindow);
        const int minWidth = 800;
        const int minHeight = 600;

        // 启用最小化按钮并设置最小尺寸约束
        var windowStyle = PInvoke.User32.GetWindowLongPtr(hwnd, PInvoke.User32.WindowLongFlags.GWL_STYLE);
        PInvoke.User32.SetWindowLongPtr(hwnd, PInvoke.User32.WindowLongFlags.GWL_STYLE,
            windowStyle | (int)PInvoke.User32.WindowStyles.WS_MINIMIZEBOX);

        // 应用最小尺寸限制
        PInvoke.User32.SetWindowPos(hwnd,
            PInvoke.User32.SpecialWindowHandles.HWND_TOP,
            0, 0, minWidth, minHeight,
            PInvoke.User32.SetWindowPosFlags.SWP_NOMOVE | PInvoke.User32.SetWindowPosFlags.SWP_NOZORDER);
    });
#endif

    MainPage = new MainPage();
}

方式二：在Windows平台专属文件中处理 #

打开项目中Platforms/Windows/MainWindow.xaml.cs文件，直接在窗口激活时设置最小尺寸：

using WinRT.Interop;

namespace YourAppName.WinUI;

public sealed partial class MainWindow : MauiWinUIWindow
{
    public MainWindow()
    {
        InitializeComponent();
        Activated += MainWindow_Activated;
    }

    private void MainWindow_Activated(object sender, Microsoft.UI.Xaml.WindowActivatedEventArgs e)
    {
        IntPtr hwnd = WindowNative.GetWindowHandle(this);
        const int minWidth = 800;
        const int minHeight = 600;

        // 使用SetWindowMinSize直接设置最小尺寸
        var minSize = new PInvoke.User32.SIZE { cx = minWidth, cy = minHeight };
        PInvoke.User32.SetWindowMinSize(hwnd, ref minSize);
    }
}

注意事项 #

• 确保已安装Microsoft.Windows.CsWin32 NuGet包，否则PInvoke.User32相关API无法使用。
• 所有Windows平台专属代码必须放在#if WINDOWS条件编译块中，避免影响Android平台编译。
• 若SetWindowMinSize出现兼容性问题，可改用WM_GETMINMAXINFO消息钩子实现：

private void MainWindow_Activated(object sender, Microsoft.UI.Xaml.WindowActivatedEventArgs e)
{
    IntPtr hwnd = WindowNative.GetWindowHandle(this);
    PInvoke.User32.SetWindowSubclass(hwnd, WindowProc, 0, 0);
}

private static IntPtr WindowProc(IntPtr hWnd, uint uMsg, IntPtr wParam, IntPtr lParam, uint uIdSubclass, uint dwRefData)
{
    if (uMsg == PInvoke.User32.WindowMessage.WM_GETMINMAXINFO)
    {
        var minMaxInfo = System.Runtime.InteropServices.Marshal.PtrToStructure<PInvoke.User32.MINMAXINFO>(lParam);
        const int minWidth = 800;
        const int minHeight = 600;
        minMaxInfo.ptMinTrackSize.x = minWidth;
        minMaxInfo.ptMinTrackSize.y = minHeight;
        System.Runtime.InteropServices.Marshal.StructureToPtr(minMaxInfo, lParam, true);
    }
    return PInvoke.User32.DefSubclassProc(hWnd, uMsg, wParam, lParam);
}

内容的提问来源于stack exchange，提问作者curiousMind_85