ColorToByteGreenConverter

ColorToByteGreenConverter は、ユーザーが受け取った Color を 0 から 255 までの値として緑コンポーネントに変換できる一方向のコンバーターです。

Convert メソッドは、指定された value から緑コンポーネントを 0 から 255 までの値として返します。

この ConvertBack メソッドはサポートされていません。

BaseConverter のプロパティ

基底クラス public abstract class BaseConverter には、次のプロパティが実装されています。

ICommunityToolkitValueConverter のプロパティ

public interface ICommunityToolkitValueConverter には次のプロパティが実装されています。

構文

次の例は、ColorToByteGreenConverter を使って、特定の Color の緑コンポーネントを表示する方法を示しています。

XAML

XAML 名前空間を含める

XAML でこのツールキットを使用するには、次の xmlns をページまたはビューに追加する必要があります。

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

したがって、以下のコードは、

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

次のように、xmlns を含むように変更されます。

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

ColorToByeGreenConverter の使用

ColorToByteGreenConverter は、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.ColorToByteGreenConverterPage">

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

    <VerticalStackLayout>
         <Label Text="The green component is:" />

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

</ContentPage>

C#

ColorToByteGreenConverter は、C# では次のように使用できます。

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

        label.SetBinding(
            Label.TextProperty,
            new Binding(
                static (ViewModel vm) => vm.MyFavoriteColor,
                converter: new ColorToByteGreenConverter()));

        Content = new VerticalStackLayout
        {
            Children =
            {
                new Label { Text = "The green component is:" },
                label
            }
        };
    }
}

C# Markup

この CommunityToolkit.Maui.Markup パッケージを使うと、より簡潔な方法でこのコンバーターを C# で使用できます。

using CommunityToolkit.Maui.Markup;

class ColorToByteGreenConverterPage : ContentPage
{
    public ColorToByteGreenConverterPage()
    {
        Content = new VerticalStackLayout
        {
            Children =
            {
                new Label()
                    .Text("The green component is:"),
                new Label()
                    .Bind(
                        Label.TextProperty,
                        static (ViewModel vm) => vm.MyFavoriteColor,
                        converter: new ColorToByteGreenConverter())
            }
        };
    }
}

例

このコンバーターの動作の例は、.NET MAUI Community Toolkit サンプル アプリケーションで確認できます。

API

ColorToByteGreenConverter のソース コードは、.NET MAUI Community Toolkit の GitHub リポジトリにあります。