.NET MAUI Switch视觉状态管理器无法设置Off状态的OnColor

问题背景 #

在Android平台的黑色背景界面中使用MAUI Switch控件时，已通过视觉状态管理器配置了On状态的OnColor、ThumbColor，以及Off状态的ThumbColor，但无法通过VisualState修改Off状态的轨道颜色——当前Off状态轨道融入黑色背景，希望将其设为灰色。

现有Switch代码：

<Switch IsToggled="True" Style="{StaticResource ToggleSwitch}" />

Styles.xaml中的自定义样式：

<Style x:Key="ToggleSwitch" TargetType="Switch">
    <Setter Property="VisualStateManager.VisualStateGroups">
        <VisualStateGroupList>
            <VisualStateGroup x:Name="CommonStates">
                <VisualState x:Name="On">
                    <VisualState.Setters>
                        <Setter Property="OnColor" Value="Green" />
                    </VisualState.Setters>
                </VisualState>
                <VisualState x:Name="Off">
                    <VisualState.Setters>
                        <Setter Property="OnColor" Value="Gray" />
                    </VisualState.Setters>
                </VisualState>
            </VisualStateGroup>
        </VisualStateGroupList>
    </Setter>
</Style>

尝试过修改Background/BackgroundColor，但因界面背景必须为黑色，该方案不可行；优先选择原生/接近原生的解决方案，不考虑自定义控件。

核心原因 #

MAUI Switch的OnColor属性仅控制On状态的轨道颜色，Off状态的轨道颜色并不受该属性影响，因此在Off状态的VisualState中设置OnColor完全无效。Android原生Switch的Off状态轨道颜色由trackTint属性控制，必须通过平台特定的扩展来修改。

解决方案（原生Handler实现） #

通过MAUI的Handler机制扩展Android平台的Switch控件，无需自定义控件，属于原生适配方案：

1. 在Android项目的Platforms/Android目录下创建CustomSwitchHandler.cs：

using Android.Widget;
using Microsoft.Maui.Handlers;

namespace YourAppNamespace.Platforms.Android;

public class CustomSwitchHandler : SwitchHandler
{
    protected override void ConnectHandler(SwitchCompat platformView)
    {
        base.ConnectHandler(platformView);
        
        // 方式1：直接设置Off状态轨道颜色为灰色（On状态仍沿用MAUI的OnColor设置）
        platformView.TrackTintList = Android.Content.Res.ColorStateList.ValueOf(Android.Graphics.Color.Gray);

        // 方式2：区分On/Off状态的轨道颜色（覆盖MAUI的OnColor设置）
        // var colorStateList = new Android.Content.Res.ColorStateList(
        //     new int[][]
        //     {
        //         new int[] { Android.Resource.Attribute.StateChecked }, // On状态
        //         new int[] { -Android.Resource.Attribute.StateChecked } // Off状态
        //     },
        //     new int[]
        //     {
        //         Android.Graphics.Color.Green, // On状态轨道颜色
        //         Android.Graphics.Color.Gray   // Off状态轨道颜色
        //     });
        // platformView.TrackTintList = colorStateList;
    }
}

2. 在Android项目的MauiProgram.cs中注册自定义Handler：

using Microsoft.Maui.Hosting;
using YourAppNamespace.Platforms.Android;

namespace YourAppNamespace;

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .ConfigureMauiHandlers(handlers =>
            {
#if ANDROID
                handlers.AddHandler(typeof(Microsoft.Maui.Controls.Switch), typeof(CustomSwitchHandler));
#endif
            });

        return builder.Build();
    }
}

3. 保留原有的VisualState配置（用于控制ThumbColor和On状态的颜色），此时Off状态的轨道颜色会被Handler设置为灰色，不再融入黑色背景。

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