ColorToHexRgbStringConverter

Articolo
03/09/2024

ColorToHexRgbStringConverter è un convertitore che consente agli utenti di convertire un'associazione Color di valori nel relativo equivalente esadecimale string RGB nel formato: #redgreenblue dove rosso, verde e blu sarà un valore compreso tra 0 e FF ,ad esempio #FF0000 per Colors.Red.

Il Convert metodo restituisce l'oggetto fornito Colorvalue convertito nell'equivalente esadecimale string RGB.

Il ConvertBack metodo restituisce l'esadecimale stringvalue RGB convertito in un oggetto Color.

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

Gli esempi seguenti illustrano come usare per ColorToHexRgbStringConverter visualizzare la stringa equivalente esadecimale RGB 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 ColorToHexRgbStringConverter

Può ColorToHexRgbStringConverter 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.ColorToHexRgbStringConverterPage">

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

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

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

</ContentPage>

C#

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

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

	label.SetBinding(
		Label.TextProperty,
		new Binding(
			nameof(ViewModel.MyFavoriteColor),
			converter: new ColorToHexRgbStringConverter()));

	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 ColorToHexRgbStringConverterPage : ContentPage
{
    public ColorToHexRgbStringConverterPage()
    {
        Content = new VerticalStackLayout
        {
            Children =
            {
                new Label()
                    .Text("My favourite Color is:"),
                new Label()
                    .Bind(
                        Label.TextProperty,
                        static (ViewModel vm) => vm.MyFavoriteColor,
                        converter: new ColorToHexRgbStringConverter())
            }
        };
    }
}

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 ColorToHexRgbStringConverter over nel repository GitHub di .NET MAUI Community Toolkit.

Condividi tramite