Compartilhar via


Modo de cor herdado do VisualElement no Windows

Algumas das Xamarin.Forms exibições apresentam um modo de cores herdado. Nesse modo, quando a IsEnabled propriedade do modo de exibição é definida como false, o modo de exibição substituirá as cores definidas pelo usuário pelas cores nativas padrão para o estado desabilitado. Para compatibilidade com versões anteriores, esse modo de cor herdado continua sendo o comportamento padrão para exibições com suporte.

Esse específico da plataforma da Plataforma Universal do Windows desabilita esse modo de cores herdado, para que as cores definidas em um modo de exibição pelo usuário permaneçam mesmo quando o modo de exibição estiver desabilitado. Ele é consumido em XAML definindo a propriedade anexada VisualElement.IsLegacyColorModeEnabled como false:

<ContentPage ...
             xmlns:windows="clr-namespace:Xamarin.Forms.PlatformConfiguration.WindowsSpecific;assembly=Xamarin.Forms.Core">
    <StackLayout>
        ...
        <Editor Text="Enter text here"
                TextColor="Blue"
                BackgroundColor="Bisque"
                windows:VisualElement.IsLegacyColorModeEnabled="False" />
        ...
    </StackLayout>
</ContentPage>

Como alternativa, ele pode ser consumido do C# usando a API fluente:

using Xamarin.Forms.PlatformConfiguration;
using Xamarin.Forms.PlatformConfiguration.WindowsSpecific;
...

_legacyColorModeDisabledEditor.On<Windows>().SetIsLegacyColorModeEnabled(false);

O VisualElement.On<Windows> método especifica que esse específico da plataforma só será executado no Windows. O VisualElement.SetIsLegacyColorModeEnabled método, no Xamarin.Forms.PlatformConfiguration.WindowsSpecific namespace, é usado para controlar se o modo de cor herdado está desabilitado. Além disso, o VisualElement.GetIsLegacyColorModeEnabled método pode ser usado para retornar se o modo de cor herdado está desabilitado.

O resultado é que o modo de cores herdado pode ser desabilitado, de modo que as cores definidas em um modo de exibição pelo usuário permaneçam mesmo quando o modo de exibição estiver desabilitado:

Modo de cores herdadas desativado

Observação

Ao definir um em uma exibição, o modo de VisualStateGroup cor herdado é completamente ignorado. Para obter mais informações sobre estados visuais, consulte O Xamarin.Forms Gerenciador de Estado Visual.