ColorToCmykaStringConverter

Artículo
03/14/2024

El ColorToCmykaStringConverter es un convertidor unidireccional que permite a los usuarios convertir un enlace de valor Color a su CMYKAstring equivalente en el formato: CMYKA(cian,magenta,amarillo,clave,alfa) donde cyan, magenta, amarillo y clave será un valor entre el 0 % y el 100 %, y alfa será un valor entre o y 1 (por ejemplo, CMYKA(0%,100%,100%,0%,1) para Colors.Red.

El método Convert devuelve el Colorvalue proporcionado convertido a su string CMYKA equivalente.

No se admite el método ConvertBack.

Propiedades de BaseConverter

Las siguientes propiedades se implementan en la clase base, public abstract class BaseConverter:

Propiedad	Descripción
`DefaultConvertReturnValue`	Valor predeterminado que se devuelve cuando `IValueConverter.Convert(object?, Type, object?, CultureInfo?)` produce una `Exception`. Este valor se usa cuando CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` se establece en `true`.
`DefaultConvertBackReturnValue`	Valor predeterminado que se devuelve cuando `IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?)` produce una `Exception`. Este valor se usa cuando CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` se establece en `true`.

Propiedades de ICommunityToolkitValueConverter

Las siguientes propiedades se implementan en public interface ICommunityToolkitValueConverter:

Propiedad	Tipo	Descripción
`DefaultConvertReturnValue`	`object?`	Valor predeterminado que se devuelve cuando `IValueConverter.Convert(object?, Type, object?, CultureInfo?)` produce una `Exception`. Este valor se usa cuando CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` se establece en `true`.
`DefaultConvertBackReturnValue`	`object?`	Valor predeterminado que se devuelve cuando `IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?)` produce una `Exception`. Este valor se usa cuando CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` se establece en `true`.

Sintaxis

En los ejemplos siguientes se muestra cómo usar ColorToCmykaStringConverter para mostrar la cadena equivalente de CMYKA de un determinado Color.

XAML

Incluir el espacio de nombres XAML

Para usar el kit de herramientas en XAML, es necesario agregar el siguiente xmlns a la página o vista:

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

Por lo tanto, el siguiente:

<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>

Se modificaría para incluir el xmlns de la siguiente manera:

<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>

Usar ColorToCmykaStringConverter

El ColorToCmykaStringConverter se puede usar de la siguiente manera en 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.ColorToCmykaStringConverterPage">

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

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

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

</ContentPage>

C#

El ColorToCmykaStringConverter se puede usar de la siguiente manera en C#:

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

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

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

Marcado de C#

NuestroCommunityToolkit.Maui.Markup paquete proporciona una forma mucho más concisa de usar este convertidor en C#.

using CommunityToolkit.Maui.Markup;

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

Ejemplos

Puede encontrar un ejemplo de este convertidor en acción en la Aplicación de muestra del kit de herramientas de la comunidad de .NET MAUI.

API

Puede encontrar el código fuente de ColorToCmykaStringConverter en el repositorio de GitHub del Kit de herramientas de la comunidad de .NET MAUI.

Compartir a través de