ColorToHslaStringConverter

Articolo
11/11/2023

ColorToHslaStringConverter è un convertitore unidirezionale che consente agli utenti di convertire un Color binding di valori nel formato HSLA string equivalente: HSLA(hue,saturazione,leggerezza,alfa) dove hue sarà un valore compreso tra 0 e 360, saturazione e leggerezza sarà un valore compreso tra 0% e 100%, e alfa sarà un valore compreso tra 0 e 1 (ad esempio HSLA(0,100%, 50%,1) per Colors.Red.

Il Convert metodo restituisce l'oggetto Color value fornito convertito nell'equivalente HSLA string .

Il ConvertBack metodo non è supportato.

Proprietà BaseConverter

Le proprietà seguenti vengono implementate nella classe base : public abstract class BaseConverter

Proprietà	Descrizione
`DefaultConvertReturnValue`	Valore predefinito da restituire quando `IValueConverter.Convert(object?, Type, object?, CultureInfo?)` genera un'eccezione `Exception`. Questo valore viene usato quando CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` è impostato su `true`.
`DefaultConvertBackReturnValue`	Valore predefinito da restituire quando `IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?)` genera un'eccezione `Exception`. Questo valore viene usato quando CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` è impostato su `true`.

Proprietà ICommunityToolkitValueConverter

Le proprietà seguenti vengono implementate in public interface ICommunityToolkitValueConverter:

Proprietà	Type	Descrizione
`DefaultConvertReturnValue`	`object?`	Valore predefinito da restituire quando `IValueConverter.Convert(object?, Type, object?, CultureInfo?)` genera un'eccezione `Exception`. Questo valore viene usato quando CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` è impostato su `true`.
`DefaultConvertBackReturnValue`	`object?`	Valore predefinito da restituire quando `IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?)` genera un'eccezione `Exception`. Questo valore viene usato quando CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` è impostato su `true`.

Sintassi

Negli esempi seguenti viene illustrato come usare per ColorToHslaStringConverter visualizzare la stringa equivalente HSLA di un oggetto specifico Color.

XAML

Inclusione dello spazio dei nomi XAML

Per usare il toolkit in XAML, è necessario aggiungere le informazioni seguenti xmlns nella pagina o nella visualizzazione:

xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"

Di conseguenza:

<ContentPage
    x:Class="CommunityToolkit.Maui.Sample.Pages.MyPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml">

</ContentPage>

Verrà modificato in modo da includere l'oggetto xmlns come indicato di seguito:

<ContentPage
    x:Class="CommunityToolkit.Maui.Sample.Pages.MyPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit">

</ContentPage>

Uso di ColorToHslaStringConverter

Può ColorToHslaStringConverter essere usato come segue in XAML:

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"
             x:Class="CommunityToolkit.Maui.Sample.Pages.Converters.ColorToHslaStringConverterPage">

    <ContentPage.Resources>
        <ResourceDictionary>
            <toolkit:ColorToHslaStringConverter x:Key="ColorToHslaStringConverter" />
        </ResourceDictionary>
    </ContentPage.Resources>

    <VerticalStackLayout>
        <Label Text="My favourite Color is:" />

        <Label Text="{Binding MyFavoriteColor, Converter={StaticResource ColorToHslaStringConverter}}" />
    </VerticalStackLayout>

</ContentPage>

C#

Può ColorToHslaStringConverter essere usato come indicato di seguito in C#:

class ColorToHslaStringConverterPage : ContentPage
{
    public ColorToHslaStringConverterPage()
    {
        var label = new Label();

        label.SetBinding(
            Label.TextProperty,
            new Binding(
                static (ViewModel vm) => vm.MyFavoriteColor,
                converter: new ColorToHslaStringConverter()));

        Content = new VerticalStackLayout
        {
            Children =
            {
                new Label { Text = "My favourite Color is:" },
                label
            }
        };
    }
}

C# Markup

Il CommunityToolkit.Maui.Markup pacchetto offre un modo molto più conciso per usare questo convertitore in C#.

using CommunityToolkit.Maui.Markup;

class ColorToHslaStringConverterPage : ContentPage
{
    public ColorToHslaStringConverterPage()
    {
        Content = new VerticalStackLayout
        {
            Children =
            {
                new Label()
                    .Text("My favourite Color is:"),
                new Label()
                    .Bind(
                        Label.TextProperty,
                        static (ViewModel vm) => vm.MyFavoriteColor,
                        converter: new ColorToHslaStringConverter())
            }
        };
    }
}

Esempi

È possibile trovare un esempio di questo convertitore in azione nell'applicazione di esempio .NET MAUI Community Toolkit.

API

È possibile trovare il codice sorgente per ColorToHslaStringConverter over nel repository GitHub di .NET MAUI Community Toolkit.

Condividi tramite