ColorAnimationExtensions

ColorAnimationExtensions には、VisualElement の Color 関連プロパティのアニメーション化をサポートする、一連の拡張メソッドが用意されています。

ColorAnimationExtensions は CommunityToolkit.Maui.Extensions 名前空間の下に存在するため、開始するには次の行を追加します。

using CommunityToolkit.Maui.Extensions;

BackgroundColorTo

BackgroundColorTo メソッドを使用すると、VisualElement の BackgroundColor の変更をアニメーション化できます。

構文

次の例では、Label で BackgroundColor を Colors.White から Colors.Red にアニメーション化する方法を示しています。

using CommunityToolkit.Maui.Extensions;

var label = new Label
{
    BackgroundColor = Colors.White
};

await label.BackgroundColorTo(Colors.Red);

BackgroundColorTo メソッドの完全な引数リストは次のとおりです。

• Color 型の color は、VisualElement の BackgroundColor をアニメーション化する対象の色です。
• uint 型の rate は、アニメーションのフレーム間の時間 (ミリ秒) です。 これはオプションの引数で、既定値は 16 です。
• uint 型の length は、アニメーションの継続時間 (ミリ秒) です。 これはオプションの引数で、既定値は 250 です。
• Easing 型の easing は、アニメーションで使用するイージング関数です。 この引数は省略可能であり、既定値は null です。

TextColorTo

TextColorTo メソッドを使用すると、ITextStyle の実装の TextColor の変更をアニメーション化できます。

using CommunityToolkit.Maui.Extensions;

var label = new Label
{
    TextColor = Colors.Green
};

await label.TextColorTo(Colors.Red);

TextColorTo メソッドの完全な引数リストは次のとおりです。

• Color 型の color は、VisualElement の BackgroundColor をアニメーション化する対象の色です。
• uint 型の rate は、アニメーションのフレーム間の時間 (ミリ秒) です。 これはオプションの引数で、既定値は 16 です。
• uint 型の length は、アニメーションの継続時間 (ミリ秒) です。 これはオプションの引数で、既定値は 250 です。
• Easing 型の easing は、アニメーションで使用するイージング関数です。 この引数は省略可能であり、既定値は null です。

Note

TextColorTo メソッドは、ソース ジェネレーターを使用してコンパイル時に生成されます。 これは、ITextStyle.TextColor が読み取り専用であるためです。 ソース ジェネレーターのソース コードは、.NET MAUI Community Toolkit の GitHub リポジトリで確認できます

例

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

API

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