Le ColorToHslaStringConverter est un convertisseur unidirectionnel permettant aux utilisateurs de convertir une liaison de valeur Color en son équivalent string HSLA au format : HSLA(teinte,saturation, clarté,alpha) où la teinte sera une valeur comprise entre 0 et 360, la saturation et la clarté seront une valeur comprise entre 0 % et 100 %, et l’alpha sera une valeur comprise entre 0 et 1 (par exemple, HSLA(0,100%,50%,1 pour Colors.Red).
La méthode Convert retourne le Colorvalue fourni converti en son équivalent string HSLA.
La méthode ConvertBack n'est pas prise en charge.
Propriétés BaseConverter
Les propriétés suivantes sont implémentées dans la classe de base, public abstract class BaseConverter :
Propriété
Description
DefaultConvertReturnValue
Valeur par défaut à renvoyer lorsque IValueConverter.Convert(object?, Type, object?, CultureInfo?) lève un Exception. Cette valeur est utilisée lorsque CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters est défini sur true.
DefaultConvertBackReturnValue
Valeur par défaut à retourner lorsque IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?) lève un Exception. Cette valeur est utilisée lorsque CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters est défini sur true.
Propriétés ICommunityToolkitValueConverter
Les propriétés suivantes sont implémentées dans le public interface ICommunityToolkitValueConverter :
Propriété
Type
Description
DefaultConvertReturnValue
object?
Valeur par défaut à renvoyer lorsque IValueConverter.Convert(object?, Type, object?, CultureInfo?) lève un Exception. Cette valeur est utilisée lorsque CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters est défini sur true.
DefaultConvertBackReturnValue
object?
Valeur par défaut à retourner lorsque IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?) lève un Exception. Cette valeur est utilisée lorsque CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters est défini sur true.
Syntaxe
Les exemples suivants montreront comment utiliser le ColorToHslaStringConverter pour afficher la chaîne équivalente HSLA d'un fichier Color spécifique.
XAML
Y compris l’espace de noms XAML
Pour utiliser le kit de ressources dans XAML, le xmlns suivant doit être ajouté à votre page ou à votre affichage :
Le ColorToHslaStringConverter peut être utilisé de la manière suivante dans 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
}
};
}
}
Balisage C#
Notre package CommunityToolkit.Maui.Markup fournit une manière beaucoup plus concise d’utiliser ce convertisseur en 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())
}
};
}
}
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner les problèmes et les demandes de tirage. Pour plus d’informations, consultez notre guide du contributeur.
Commentaires sur .NET MAUI Community Toolkit
.NET MAUI Community Toolkit est un projet open source. Sélectionnez un lien pour fournir des commentaires :
Créer une interface utilisateur avec la liaison de données. Votre interface utilisateur est automatiquement mise à jour en fonction des données les plus récentes, tandis que les données sont mises à jour suite aux modifications apportées à l’interface utilisateur.