Modalità colore legacy di VisualElement in Android

  • Articolo

Download Sample Scaricare l'esempio

Alcune visualizzazioni Xamarin.Forms presentano una modalità colore legacy. In questa modalità, quando la IsEnabled proprietà della visualizzazione è impostata su false, la visualizzazione sostituirà i colori impostati dall'utente con i colori nativi predefiniti per lo stato disabilitato. Per la compatibilità con le versioni precedenti, questa modalità colore legacy rimane il comportamento predefinito per le visualizzazioni supportate.

Questo specifico della piattaforma Android disabilita questa modalità di colore legacy, in modo che i colori impostati su una visualizzazione dall'utente rimangano anche quando la visualizzazione è disabilitata. Viene utilizzata in XAML impostando la VisualElement.IsLegacyColorModeEnabled proprietà associata su false:

<ContentPage ...
             xmlns:android="clr-namespace:Xamarin.Forms.PlatformConfiguration.AndroidSpecific;assembly=Xamarin.Forms.Core">
    <StackLayout>
        ...
        <Button Text="Button"
                TextColor="Blue"
                BackgroundColor="Bisque"
                android:VisualElement.IsLegacyColorModeEnabled="False" />
        ...
    </StackLayout>
</ContentPage>

In alternativa, può essere usato da C# usando l'API Fluent:

using Xamarin.Forms.PlatformConfiguration;
using Xamarin.Forms.PlatformConfiguration.AndroidSpecific;
...

_legacyColorModeDisabledButton.On<Android>().SetIsLegacyColorModeEnabled(false);

Il VisualElement.On<Android> metodo specifica che questa specifica della piattaforma verrà eseguita solo in Android. Il VisualElement.SetIsLegacyColorModeEnabled metodo, nello Xamarin.Forms.PlatformConfiguration.AndroidSpecific spazio dei nomi , viene usato per controllare se la modalità colore legacy è disabilitata. Inoltre, il VisualElement.GetIsLegacyColorModeEnabled metodo può essere usato per restituire se la modalità colore legacy è disabilitata.

Il risultato è che la modalità colore legacy può essere disabilitata, in modo che i colori impostati su una visualizzazione dall'utente rimangano anche quando la visualizzazione è disabilitata:

Legacy color mode disabled

Nota

Quando si imposta un oggetto VisualStateGroup in una visualizzazione, la modalità colore legacy viene completamente ignorata. Per altre informazioni sugli stati di visualizzazione, vedere Xamarin.Forms Visual State Manager.