ColorToHslaStringConverter
Jedná se ColorToHslaStringConverter
o jednosměrný převaděč, který uživatelům umožňuje převést Color
vazbu hodnot na jeho ekvivalent HSLA string
ve formátu: HSLA(hue,sytost,světlost,alfa), kde odstín bude hodnota mezi 0 a 360, sytost a lehkost bude hodnota mezi 0% a 100% a alfa bude hodnota mezi 0 a 1 (např. HSLA(0,100%, 50 %,1) pro Colors.Red
.
Metoda Convert
vrátí zadaný Color
value
převedený na jeho ekvivalent HSLA string
.
Metoda ConvertBack
není podporována.
BaseConverter – vlastnosti
V základní třídě jsou implementovány následující vlastnosti: public abstract class BaseConverter
Vlastnost | Popis |
---|---|
DefaultConvertReturnValue |
Výchozí hodnota, která se má vrátit při IValueConverter.Convert(object?, Type, object?, CultureInfo?) vyvolání .Exception Tato hodnota se používá, když Je nastavena možnost true CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters . |
DefaultConvertBackReturnValue |
Výchozí hodnota, která se má vrátit při IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?) vyvolání .Exception Tato hodnota se používá, když Je nastavena možnost true CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters . |
ICommunityToolkitValueConverter – vlastnosti
Následující vlastnosti jsou implementovány v public interface ICommunityToolkitValueConverter
:
Vlastnost | Type | Popis |
---|---|---|
DefaultConvertReturnValue |
object? |
Výchozí hodnota, která se má vrátit při IValueConverter.Convert(object?, Type, object?, CultureInfo?) vyvolání .Exception Tato hodnota se používá, když Je nastavena možnost true CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters . |
DefaultConvertBackReturnValue |
object? |
Výchozí hodnota, která se má vrátit při IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?) vyvolání .Exception Tato hodnota se používá, když Je nastavena možnost true CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters . |
Syntaxe
Následující příklady ukazují, jak použít ColorToHslaStringConverter
k zobrazení ekvivalentního řetězce HSLA konkrétního Color
.
XAML
Zahrnutí oboru názvů XAML
Pokud chcete použít sadu nástrojů v XAML, musíte do stránky nebo zobrazení přidat následující xmlns
položky:
xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"
Proto platí následující:
<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>
Bylo by změněno tak, aby zahrnovalo xmlns
následující:
<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>
Použití ColorToHslaStringConverter
V XAML je možné ho ColorToHslaStringConverter
použít následujícím způsobem:
<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#
V ColorToHslaStringConverter
jazyce C# je možné ho použít následujícím způsobem:
class ColorToHslaStringConverterPage : ContentPage
{
public ColorToHslaStringConverterPage()
{
var label = new Label();
label.SetBinding(
Label.TextProperty,
new Binding(
nameof(ViewModel.MyFavoriteColor),
converter: new ColorToHslaStringConverter()));
Content = new VerticalStackLayout
{
Children =
{
new Label { Text = "My favourite Color is:" },
label
}
};
}
}
Revize jazyka C#
Náš CommunityToolkit.Maui.Markup
balíček nabízí mnohem stručnější způsob použití tohoto převaděče v jazyce 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())
}
};
}
}
Příklady
Příklad tohoto převaděče najdete v akci v ukázkové aplikaci .NET MAUI Community Toolkit.
rozhraní API
Zdrojový kód ColorToHslaStringConverter
najdete v úložišti .NET MAUI Community Toolkit na GitHubu.
.NET MAUI Community Toolkit
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro