MAUI iOS ImageButton：如何设置自定义按钮类型防止图片变暗？

方案：自定义Handler修改原生iOS按钮行为 #

MAUI的ImageButton在iOS端默认映射为UIButton，默认会在按下时添加高亮滤镜导致图片变暗。要实现类似Xcode中「Custom」按钮的无默认高亮效果，无需重建按钮，直接在自定义Handler中修改原生控件属性即可：

1. 创建自定义ImageButton Handler #

在iOS项目中添加如下类：

using Microsoft.Maui.Handlers;
using UIKit;

namespace YourAppNamespace.Platforms.iOS
{
    public class CustomImageButtonHandler : ImageButtonHandler
    {
        protected override void ConnectHandler(UIButton platformView)
        {
            base.ConnectHandler(platformView);
            
            // 禁用高亮时的图片自动变暗效果
            platformView.AdjustsImageWhenHighlighted = false;
            // 可选：禁用禁用状态下的图片变暗
            platformView.AdjustsImageWhenDisabled = false;
            
            // 清除默认背景，完全模拟Custom按钮无样式特性
            platformView.BackgroundColor = UIColor.Clear;
        }
    }
}

2. 在MauiProgram中注册Handler #

在项目根目录的MauiProgram.cs中注册自定义Handler，让MAUI使用这个自定义处理逻辑：

using YourAppNamespace.Platforms.iOS;

public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();
    builder
        .UseMauiApp<App>()
        .ConfigureMauiHandlers(handlers =>
        {
#if IOS
            handlers.AddHandler<ImageButton, CustomImageButtonHandler>();
#endif
        });

    return builder.Build();
}

3. 保留原有VisualState设置 #

你之前在XAML中配置的Normal和Pressed状态图片切换依然生效，现在按下按钮时不会再出现默认的深色高亮：

<ImageButton>
    <VisualStateManager.VisualStateGroups>
        <VisualStateGroup x:Name="CommonStates">
            <VisualState x:Name="Normal">
                <VisualState.Setters>
                    <Setter Property="Source" Value="btn_green_normal.png" />
                </VisualState.Setters>
            </VisualState>
            <VisualState x:Name="Pressed">
                <VisualState.Setters>
                    <Setter Property="Source" Value="btn_green_pressed.png" />
                </VisualState.Setters>
            </VisualState>
        </VisualStateGroup>
    </VisualStateManager.VisualStateGroups>
</ImageButton>

原理说明 #

iOS原生UIButton的AdjustsImageWhenHighlighted属性默认值为true，会在按钮高亮（按下）时自动给图片添加深色滤镜；将其设为false即可禁用该默认行为，完全使用你自定义的Pressed状态图片。这种方式无需修改按钮构造函数，直接在Handler的ConnectHandler方法中修改已创建的原生控件属性，完美适配已存在的XAML按钮。

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