CompositionRadialGradientBrush 類別

定義

命名空間:

Windows.UI.Composition

表示使用星形漸層繪製區域的筆刷。

public ref class CompositionRadialGradientBrush sealed : CompositionGradientBrush

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 524288)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CompositionRadialGradientBrush final : CompositionGradientBrush

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 524288)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CompositionRadialGradientBrush : CompositionGradientBrush

Public NotInheritable Class CompositionRadialGradientBrush
Inherits CompositionGradientBrush

繼承

Object Platform::Object IInspectable CompositionObject CompositionBrush CompositionGradientBrush CompositionRadialGradientBrush

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10, version 1903 (已於 10.0.18362.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v8.0 引進)

範例

建立星形漸層筆刷

此範例示範如何建立星形漸層筆刷、新增 2 個色彩停駐點，並繪製 SpriteVisual。

// Create radial gradient brush.
CompositionRadialGradientBrush RGBrush = compositor.CreateRadialGradientBrush();

// Create the color stops by defining the offset and color.
CompositionColorGradientStop ColorStop1 = compositor.CreateColorGradientStop();
ColorStop1.Offset = 0;
ColorStop1.Color = Colors.Blue;
CompositionColorGradientStop ColorStop2 = compositor.CreateColorGradientStop();
ColorStop2.Offset = 1;
ColorStop2.Color = Colors.Yellow;

// Add the color stops to brush's ColorStops collection.
RGBrush.ColorStops.Add(ColorStop1);
RGBrush.ColorStops.Add(ColorStop2);

// Create a sprite visual and paint it with the radial gradient brush.
var visual = compositor.CreateSpriteVisual();
visual.Size = new Vector2(120, 120);
visual.Brush = RGBrush;

您也可以使用這個較短的語法來壓縮建立和新增色彩停止點的步驟：

RGBrush.ColorStops.Add(compositor.CreateColorGradientStop(0, Colors.Blue));
RGBrush.ColorStops.Add(compositor.CreateColorGradientStop(1, Colors.Yellow));

建立星形漸層筆刷的動畫

此範例示範如何以動畫顯示星形漸層筆刷第一個漸層停駐點的色彩。

private SpriteVisual GetRadialGradientVisualWithAnimation(Vector2 size,
                                                          Vector2 gradientOriginOffset,
                                                          Vector2 ellipseCenter,
                                                          Vector2 ellipseRadius)
{
    // Create radial gradient brush.
    var gradientBrush = compositor.CreateRadialGradientBrush();
    gradientBrush.GradientOriginOffset = gradientOriginOffset;
    gradientBrush.EllipseCenter = ellipseCenter;
    gradientBrush.EllipseRadius = ellipseRadius;

    // Add the color stops. The first color stop needs a name so you can refer to it later.
    CompositionColorGradientStop ColorStop1 = compositor.CreateColorGradientStop(0, Colors.Blue);
    gradientBrush.ColorStops.Add(ColorStop1);
    gradientBrush.ColorStops.Add(compositor.CreateColorGradientStop(1, Colors.Yellow));

    // Set up animation for ColorStop1's color.
    var colorAnimation = compositor.CreateColorKeyFrameAnimation();
    colorAnimation.InsertKeyFrame(0.0f, Colors.Blue);
    colorAnimation.InsertKeyFrame(0.5f, Colors.LightBlue);
    colorAnimation.InsertKeyFrame(0.75f, Colors.Navy);
    colorAnimation.InsertKeyFrame(1.0f, Colors.Blue);
    colorAnimation.Duration = TimeSpan.FromSeconds(20);
    colorAnimation.IterationBehavior = AnimationIterationBehavior.Forever;
    ColorStop1.StartAnimation("Color", colorAnimation);

    // SpriteVisual to be painted with gradated content.
    var gradientVisual = compositor.CreateSpriteVisual();
    gradientVisual.Size = size;
    // Set brush on the SpriteVisual.
    gradientVisual.Brush = gradientBrush;

    return gradientVisual;
}

備註

此筆刷會使用星形漸層繪製 SpriteVisual 。

漸層是在 EllipseCenter 和 EllipseRadius 屬性所定義的橢圓形內繪製。 漸層的色彩會從橢圓形的中央開始，並在半徑上結束。

星形漸層的色彩是由色彩停駐點所定義。 每個色彩停駐點都會指定沿著漸層的色彩和位置。

屬性

AnchorPoint	取得或設定筆刷上要放置在筆刷位移的點。 (繼承來源 CompositionGradientBrush)
CenterPoint	取得或設定筆刷旋轉和縮放的點。 (繼承來源 CompositionGradientBrush)
ColorStops	取得筆刷的漸層停駐點。 (繼承來源 CompositionGradientBrush)
Comment	要與 CompositionObject 建立關聯的字串。 (繼承來源 CompositionObject)
Compositor	用來建立這個CompositionObject的Compositor。 (繼承來源 CompositionObject)
Dispatcher	CompositionObject的發送器。 (繼承來源 CompositionObject)
DispatcherQueue	取得 CompostionObject 的 DispatcherQueue 。 (繼承來源 CompositionObject)
EllipseCenter	取得或設定包含漸層之橢圓形中央的二維座標。
EllipseRadius	取得或設定包含漸層之橢圓形的弧度。
ExtendMode	取得或設定值，指定如何在筆刷的漸層向量或空間之外繪製漸層。 (繼承來源 CompositionGradientBrush)
GradientOriginOffset	取得或設定漸層原點的二維座標。
ImplicitAnimations	附加至這個物件的隱含動畫集合。 (繼承來源 CompositionObject)
InterpolationSpace	取得或設定值，指定漸層色彩的插補方式。 (繼承來源 CompositionGradientBrush)
MappingMode	取得或設定值，這個值表示漸層筆刷的位置座標 (StartPoint、EndPoint) 是否為絕對或相對於輸出區域。 (繼承來源 CompositionGradientBrush)
Offset	取得或設定筆刷相對於所繪製物件的位移。 (繼承來源 CompositionGradientBrush)
Properties	與 CompositionObject相關聯的屬性集合。 (繼承來源 CompositionObject)
RotationAngle	取得或設定筆刷的旋轉角度，以弧度為單位。 (繼承來源 CompositionGradientBrush)
RotationAngleInDegrees	取得或設定筆刷的旋轉角度，以度為單位。 (繼承來源 CompositionGradientBrush)
Scale	取得或設定要套用至筆刷的尺規。 (繼承來源 CompositionGradientBrush)
TransformMatrix	取得或設定要套用至筆刷的轉換矩陣。 (繼承來源 CompositionGradientBrush)

方法

Close()	關閉 CompositionObject 並釋放系統資源。 (繼承來源 CompositionObject)
ConnectAnimation(String, CompositionAnimation)	連接和動畫。 (繼承來源 CompositionObject)
DisconnectAnimation(String)	中斷動畫的連接。 (繼承來源 CompositionObject)
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 (繼承來源 CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	定義可以產生動畫效果的屬性。 (繼承來源 CompositionObject)
StartAnimation(String, CompositionAnimation)	使用物件的指定屬性連接動畫，並啟動動畫。 (繼承來源 CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	使用物件的指定屬性連接動畫，並啟動動畫。 (繼承來源 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	啟動動畫群組。 CompositionObject上的 StartAnimationGroup 方法可讓您啟動CompositionAnimationGroup。 群組中的所有動畫都會在 物件上同時啟動。 (繼承來源 CompositionObject)
StopAnimation(String)	中斷與指定屬性的動畫連線，並停止動畫。 (繼承來源 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	停止動畫群組。 (繼承來源 CompositionObject)
TryGetAnimationController(String)	傳回在指定屬性上執行的動畫的 AnimationController。 (繼承來源 CompositionObject)

另請參閱

• Brush