VariableMultiValueConverter

VariableMultiValueConverter to konwerter, który umożliwia użytkownikom konwertowanie wartości bool za pośrednictwem MultiBinding do pojedynczego bool. Dzięki temu można określić, czy wartości All, Any, None lub określona liczba wartości są prawdziwe, jak określono w parametrze ConditionType.

Metoda Convert zwraca podany values, przekształcony w ogólny wynik bool na podstawie zdefiniowanego ConditionType.

Metoda ConvertBack zwróci wynik tylko wtedy, gdy ConditionType parametr ma wartość MultiBindingCondition.All.

Właściwości obiektu BaseConverter

Następujące właściwości są implementowane w klasie bazowej: public abstract class BaseConverter

Majątek Description
DefaultConvertReturnValue Wartość domyślna, która ma być zwracana, gdy IValueConverter.Convert(object?, Type, object?, CultureInfo?) zgłasza wartość Exception. Ta wartość jest używana, gdy CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters jest ustawione na true
DefaultConvertBackReturnValue Wartość domyślna, która ma być zwracana, gdy IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?) zgłasza wartość Exception. Ta wartość jest używana, gdy CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters jest ustawione na true

Właściwości ICommunityToolkitValueConverter

Następujące właściwości są implementowane w pliku public interface ICommunityToolkitValueConverter:

Majątek Typ Description
DefaultConvertReturnValue object? Wartość domyślna, która ma być zwracana, gdy IValueConverter.Convert(object?, Type, object?, CultureInfo?) zgłasza wartość Exception. Ta wartość jest używana, gdy CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters jest ustawione na true
DefaultConvertBackReturnValue object? Wartość domyślna, która ma być zwracana, gdy IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?) zgłasza wartość Exception. Ta wartość jest używana, gdy CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters jest ustawione na true

Syntax

W poniższych przykładach pokazano, jak sprawić, aby element Label był niewidoczny, gdy co najmniej 2 wartości w MultiBinding dają wynik true.

XAML

Dołączanie przestrzeni nazw XAML

Aby można było używać zestawu narzędzi w języku XAML, należy dodać następujące xmlns elementy do strony lub widoku:

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

Dlatego następuje:

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

Zostanie zmodyfikowana tak, aby zawierała następujące xmlns elementy:

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

Korzystanie ze zmiennej VariableMultiValueConverter

Elementu VariableMultiValueConverter można użyć w języku XAML w następujący sposób:

<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.VariableMultiValueConverterPage">

    <ContentPage.Resources>
        <ResourceDictionary>
            <toolkit:VariableMultiValueConverter 
                x:Key="VariableMultiValueConverter"
                ConditionType="LessThan"
                Count="2" />
        </ResourceDictionary>
    </ContentPage.Resources>

    <Label Text="At least 2 toppings must be selected.">
        <Label.IsVisible>
            <MultiBinding Converter="{StaticResource VariableMultiValueConverter}">
                <Binding Path="IsCheeseSelected" />
                <Binding Path="IsHamSelected" />
                <Binding Path="IsPineappleSelected" />
            </MultiBinding>
        </Label.IsVisible>
    </Label>

</ContentPage>

C#

Elementu VariableMultiValueConverter można użyć w następujący sposób w C#:


class VariableMultiValueConverterPage : ContentPage
{
    public VariableMultiValueConverterPage()
    {
        var label = new Label
        {
            Text = "At least 2 toppings must be selected."
        };

        label.SetBinding(
            Label.IsVisibleProperty,
            new MultiBinding
            {
                Converter = new VariableMultiValueConverter
                {
                    ConditionType = MultiBindingCondition.LessThan,
                    Count = 2
                },
                Bindings = new List<BindingBase>
                {
                    new Binding(static (ViewModel vm) => vm.IsCheeseSelected),
                    new Binding(static (ViewModel vm) => vmIsHamSelected),
                    new Binding(static (ViewModel vm) => vmIsPineappleSelected)
                }
            });

        Content = label;
    }
}

Znaczniki języka C#

Nasz CommunityToolkit.Maui.Markup pakiet zapewnia znacznie bardziej zwięzły sposób używania tego konwertera w języku C#.

using CommunityToolkit.Maui.Markup;

class VariableMultiValueConverterPage : ContentPage
{
    public VariableMultiValueConverterPage()
    {
        Content = new Label()
            .Text("At least 2 toppings must be selected.")
            .Bind(
                Label.IsVisibleProperty,
                new List<BindingBase>
                {
                    new Binding(static (ViewModel vm) => vm.IsCheeseSelected),
                    new Binding(static (ViewModel vm) => vm.IsHamSelected),
                    new Binding(static (ViewModel vm) => vm.IsPineappleSelected)
                },
                converter: new VariableMultiValueConverter
                {
                    ConditionType = MultiBindingCondition.LessThan,
                    Count = 2
                });
    }
}

Właściwości

Majątek Typ Description
Typ warunku MultiBindingCondition Wskazuje, ile spośród podanych wartości logicznych w obiekcie MultiBinding powinno mieć wartość true.
Count int Liczba wartości, które powinny mieć wartość true w przypadku użycia ConditionType z GreaterThan, LessThan lub Exact.

MultiBindingCondition

Wyliczenie MultiBindingCondition definiuje następujących członków:

  • None — Żadna z wartości nie powinna być prawdziwa.
  • All — Wszystkie wartości powinny być prawdziwe.
  • Any — Każda z wartości powinna być prawdziwa.
  • Exact — Dokładna liczba skonfigurowana we Count właściwości powinna mieć wartość true.
  • GreaterThan — Większe niż liczba skonfigurowana we właściwości Count powinno mieć wartość true.
  • LessThan — Powinno być prawdą, że wartość jest mniejsza niż liczba skonfigurowana we właściwości Count.

Examples

Przykład działania tego konwertera można znaleźć w przykładowej aplikacji zestawu narzędzi .NET MAUI Community Toolkit.

API

Kod źródłowy VariableMultiValueConverter można znaleźć w repozytorium .NET MAUI Community Toolkit GitHub.