ColorToInverseColorConverter
ColorToInverseColorConverter
は、ユーザーが受信 Color
をその反転に変換することを可能にする一方向のコンバーターです。
Convert
メソッドは、指定された value
を逆に変換して返します。
ConvertBack
メソッドはサポートされていません。
BaseConverter のプロパティ
基底クラス public abstract class BaseConverter
には、次のプロパティが実装されています:
プロパティ | 説明 |
---|---|
DefaultConvertReturnValue |
IValueConverter.Convert(object?, Type, object?, CultureInfo?) によって Exception がスローされたときに返される既定値です。 この値は、CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters が true に設定されている場合に使用されます。 |
DefaultConvertBackReturnValue |
IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?) によって Exception がスローされたときに返される既定値です。 この値は、CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters が true に設定されている場合に使用されます。 |
ICommunityToolkitValueConverter のプロパティ
public interface ICommunityToolkitValueConverter
には次のプロパティが実装されています:
プロパティ | タイプ | 説明 |
---|---|---|
DefaultConvertReturnValue |
object? |
IValueConverter.Convert(object?, Type, object?, CultureInfo?) によって Exception がスローされたときに返される既定値です。 この値は、CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters が true に設定されている場合に使用されます。 |
DefaultConvertBackReturnValue |
object? |
IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?) によって Exception がスローされたときに返される既定値です。 この値は、CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters が true に設定されている場合に使用されます。 |
構文
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>
ColorToInverseColorConverter の使用
ColorToInverseColorConverter
は、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. ColorToInverseColorConverterPage">
<ContentPage.Resources>
<ResourceDictionary>
<toolkit:ColorToInverseColorConverter x:Key="ColorToInverseColorConverter" />
</ResourceDictionary>
</ContentPage.Resources>
<Label Text="This Text is the inverse of the Background"
TextColor="{Binding Source={RelativeSource AncestorType={x:Type ContentPage}}, Path=BackgroundColor, Converter={StaticResource ColorToInverseColorConverter}}" />
</ContentPage>
C#
ColorToInverseColorConverter
は、C# では次のように使用できます。
class ColorToInverseColorConverterPage : ContentPage
{
public ColorToInverseColorConverterPage()
{
var label = new Label { Text = "This Text is the inverse of the Background" };
label.SetBinding(
Label.TextColorProperty,
new Binding(
static (ContentPage page) => page.BackgroundColor,
converter: new ColorToInverseColorConverter(),
source: this));
Content = label;
}
}
C# Markup
この CommunityToolkit.Maui.Markup
パッケージは、C# でこのコンバーターを使用するためのより簡潔な方法を提供します。
using CommunityToolkit.Maui.Markup;
class ColorToInverseColorConverterPage : ContentPage
{
public ColorToInverseColorConverterPage()
{
Content = new Label { Text = "This Text is the inverse of the Background" }
.Bind(
Label.TextColorProperty,
getter: static (ContentPage page) => page.BackgroundColor,
converter: new ColorToInverseColorConverter(),
source: this);
}
}
例
このコンバーターの動作の例は、.NET MAUI Community Toolkit サンプル アプリケーションで確認できます。
API
ColorToInverseColorConverter
のソース コードは、.NET MAUI Community Toolkit の GitHub リポジトリにあります。
.NET MAUI Community Toolkit