.NET 8 MAUI：Windows与macCatalyst下ToolbarItem悬停颜色修改

针对Windows和macCatalyst平台，需要通过平台特定的方式自定义ToolbarItem的悬停状态颜色，以下是具体实现：

Windows平台 #

Windows上MAUI的ToolbarItem基于WinUI的AppBarButton，可以直接覆盖系统默认的资源刷来修改悬停状态的前景/背景色，无需修改控件模板：

1. 打开Platforms/Windows/App.xaml
2. 在Application.Resources节点下添加以下资源，替换为你需要的颜色：

<Application.Resources>
    <!-- 修改悬停时的前景色 -->
    <SolidColorBrush x:Key="AppBarButtonPointerOverForegroundBrush" Color="White"/>
    <!-- 修改悬停时的背景色 -->
    <SolidColorBrush x:Key="AppBarButtonPointerOverBackgroundBrush" Color="#20FFFFFF"/>
</Application.Resources>

如果需要更精细的自定义（比如不同圆角、动画），可以复制AppBarButton的默认控件模板，修改PointerOver视觉状态的颜色属性。

macCatalyst平台 #

macCatalyst的ToolbarItem对应UIKit的UIBarButtonItem，需要通过Handler修改高亮（悬停）状态的颜色：

全局生效方式（所有ToolbarItem） #

打开Platforms/MacCatalyst/Program.cs，在builder.UseMauiApp<App>()之后添加以下代码：

#if MACCATALYST
Microsoft.Maui.Handlers.ToolbarItemHandler.Mapper.AppendToMapping("CustomHoverColor", (handler, view) =>
{
    if (handler.PlatformView is UIBarButtonItem barButtonItem)
    {
        // 设置文字悬停颜色
        barButtonItem.SetTitleTextAttributes(new UIStringAttributes
        {
            ForegroundColor = UIColor.White // 替换为目标颜色
        }, UIControlState.Highlighted);

        // 设置图标悬停颜色（如果使用FontImageSource或图标）
        if (barButtonItem.Image != null)
        {
            barButtonItem.Image = barButtonItem.Image.ImageWithRenderingMode(UIImageRenderingMode.AlwaysTemplate);
            barButtonItem.SetTintColor(UIColor.White, UIControlState.Highlighted);
        }
    }
});
#endif

页面局部生效方式（仅当前页面的ToolbarItem） #

在页面的代码后台添加以下重写方法：

protected override void OnHandlerChanged()
{
    base.OnHandlerChanged();
#if MACCATALYST
    if (Handler is Microsoft.Maui.Handlers.PageHandler pageHandler)
    {
        foreach (var toolbarItem in ToolbarItems)
        {
            if (toolbarItem.Handler is Microsoft.Maui.Handlers.ToolbarItemHandler itemHandler && itemHandler.PlatformView is UIBarButtonItem barItem)
            {
                barItem.SetTitleTextAttributes(new UIStringAttributes { ForegroundColor = UIColor.White }, UIControlState.Highlighted);
                
                if (barItem.Image != null)
                {
                    barItem.Image = barItem.Image.ImageWithRenderingMode(UIImageRenderingMode.AlwaysTemplate);
                    barItem.SetTintColor(UIColor.White, UIControlState.Highlighted);
                }
            }
        }
    }
#endif
}

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