.NET MAUI中如何在代码后台修改Entry下划线颜色或移除该颜色？

一、修改Entry下划线颜色的可行实现方式 #

MAUI的Entry下划线是平台原生控件特性，需通过自定义Handler（MAUI官方推荐方式）跨平台实现修改，具体步骤如下：

1. 定义带下划线颜色属性的自定义Entry #

创建继承自Entry的自定义控件，添加可绑定属性用于后台动态设置下划线颜色：

public class CustomEntry : Entry
{
    public static readonly BindableProperty UnderlineColorProperty =
        BindableProperty.Create(nameof(UnderlineColor), typeof(Color), typeof(CustomEntry), Colors.Gray);

    public Color UnderlineColor
    {
        get => (Color)GetValue(UnderlineColorProperty);
        set => SetValue(UnderlineColorProperty, value);
    }
}

2. 配置平台Handler #

在MauiProgram.cs中注册自定义Handler，并针对Android/iOS分别实现下划线颜色修改逻辑：

Android平台实现

builder.ConfigureMauiHandlers(handlers =>
{
#if ANDROID
    handlers.AddHandler<CustomEntry, CustomEntryAndroidHandler>();
#endif
});

public class CustomEntryAndroidHandler : EntryHandler
{
    protected override void ConnectHandler(MauiEditText platformView)
    {
        base.ConnectHandler(platformView);
        UpdateUnderlineColor();
        VirtualView.PropertyChanged += OnPropertyChanged;
    }

    protected override void DisconnectHandler(MauiEditText platformView)
    {
        VirtualView.PropertyChanged -= OnPropertyChanged;
        base.DisconnectHandler(platformView);
    }

    private void OnPropertyChanged(object sender, PropertyChangedEventArgs e)
    {
        if (e.PropertyName == CustomEntry.UnderlineColorProperty.PropertyName)
        {
            UpdateUnderlineColor();
        }
    }

    private void UpdateUnderlineColor()
    {
        if (PlatformView != null && VirtualView is CustomEntry entry)
        {
            // 修改Android Entry下划线颜色
            PlatformView.BackgroundTintList = ColorStateList.ValueOf(entry.UnderlineColor.ToAndroid());
        }
    }
}

iOS平台实现

builder.ConfigureMauiHandlers(handlers =>
{
#if IOS
    handlers.AddHandler<CustomEntry, CustomEntryiOSHandler>();
#endif
});

public class CustomEntryiOSHandler : EntryHandler
{
    protected override void ConnectHandler(UITextField platformView)
    {
        base.ConnectHandler(platformView);
        UpdateUnderlineColor();
        VirtualView.PropertyChanged += OnPropertyChanged;
    }

    protected override void DisconnectHandler(UITextField platformView)
    {
        VirtualView.PropertyChanged -= OnPropertyChanged;
        base.DisconnectHandler(platformView);
    }

    private void OnPropertyChanged(object sender, PropertyChangedEventArgs e)
    {
        if (e.PropertyName == CustomEntry.UnderlineColorProperty.PropertyName)
        {
            UpdateUnderlineColor();
        }
    }

    private void UpdateUnderlineColor()
    {
        if (PlatformView != null && VirtualView is CustomEntry entry)
        {
            // 移除旧下划线层
            PlatformView.Layer.Sublayers = PlatformView.Layer.Sublayers?.Where(l => l.Name != "EntryUnderline").ToArray();
            // 添加新下划线并设置颜色
            var underlineLayer = new CALayer
            {
                Frame = new CGRect(0, PlatformView.Frame.Height - 1, PlatformView.Frame.Width, 1),
                BackgroundColor = entry.UnderlineColor.ToCGColor(),
                Name = "EntryUnderline"
            };
            PlatformView.Layer.AddSublayer(underlineLayer);
        }
    }
}

3. 后台代码动态修改下划线颜色 #

在页面后台代码中直接设置自定义Entry的属性即可：

// 假设页面中有id为MyCustomEntry的CustomEntry控件
MyCustomEntry.UnderlineColor = Colors.Green;

二、修复自定义Entry后Placeholder-TextColor等属性丢失问题 #

自定义控件后丢失原生Entry属性，是因为Handler未同步原生属性的初始化和变化逻辑，修复步骤如下：

1. 确保Handler调用基类方法 #

在ConnectHandler和DisconnectHandler中必须调用base.ConnectHandler(platformView)和base.DisconnectHandler(platformView)，保证原生Entry的默认属性逻辑正常执行。

2. 同步Placeholder-TextColor属性 #

在Handler中添加Placeholder颜色的同步逻辑，包括初始化和属性变化监听：

Android平台补充

在CustomEntryAndroidHandler中添加：

private void UpdatePlaceholderColor()
{
    if (PlatformView != null && VirtualView is Entry entry)
    {
        if (entry.PlaceholderColor != null)
        {
            PlatformView.SetHintTextColor(entry.PlaceholderColor.ToAndroid());
        }
    }
}

// 扩展属性变化监听
private void OnPropertyChanged(object sender, PropertyChangedEventArgs e)
{
    if (e.PropertyName == Entry.PlaceholderColorProperty.PropertyName)
    {
        UpdatePlaceholderColor();
    }
    // 保留原有的UnderlineColor监听逻辑
    if (e.PropertyName == CustomEntry.UnderlineColorProperty.PropertyName)
    {
        UpdateUnderlineColor();
    }
}

// 在ConnectHandler中初始化Placeholder颜色
protected override void ConnectHandler(MauiEditText platformView)
{
    base.ConnectHandler(platformView);
    UpdateUnderlineColor();
    UpdatePlaceholderColor();
    VirtualView.PropertyChanged += OnPropertyChanged;
}

iOS平台补充

在CustomEntryiOSHandler中添加：

private void UpdatePlaceholderColor()
{
    if (PlatformView != null && VirtualView is Entry entry)
    {
        if (!string.IsNullOrEmpty(entry.Placeholder) && entry.PlaceholderColor != null)
        {
            PlatformView.AttributedPlaceholder = new NSAttributedString(
                entry.Placeholder,
                new UIStringAttributes { ForegroundColor = entry.PlaceholderColor.ToUIColor() }
            );
        }
    }
}

// 扩展属性变化监听
private void OnPropertyChanged(object sender, PropertyChangedEventArgs e)
{
    if (e.PropertyName == Entry.PlaceholderColorProperty.PropertyName)
    {
        UpdatePlaceholderColor();
    }
    // 保留原有的UnderlineColor监听逻辑
    if (e.PropertyName == CustomEntry.UnderlineColorProperty.PropertyName)
    {
        UpdateUnderlineColor();
    }
}

// 在ConnectHandler中初始化Placeholder颜色
protected override void ConnectHandler(UITextField platformView)
{
    base.ConnectHandler(platformView);
    UpdateUnderlineColor();
    UpdatePlaceholderColor();
    VirtualView.PropertyChanged += OnPropertyChanged;
}

3. 确保自定义控件继承自Entry #

如果是自定义BorderlessEntryControl，必须直接继承Entry而非其他容器控件，才能完整继承Entry的所有原生属性。

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