CompositionRadialGradientBrush Klasse

Definition

Namespace:: Microsoft.UI.Composition

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt einen Pinsel dar, der einen Bereich mit einem radialen Farbverlauf zeichnet.

public ref class CompositionRadialGradientBrush sealed : CompositionGradientBrush

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.LiftedContract, 65536)]
/// [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.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
class CompositionRadialGradientBrush final : CompositionGradientBrush

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

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

Public NotInheritable Class CompositionRadialGradientBrush
Inherits CompositionGradientBrush

Vererbung: Object Platform::Object IInspectable CompositionObject CompositionBrush CompositionGradientBrush CompositionRadialGradientBrush

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Beispiele

Erstellen eines Radialverlaufpinsels

In diesem Beispiel wird gezeigt, wie Sie einen radialen Farbverlaufpinsel erstellen, 2 Farbstopps hinzufügen und einen SpriteVisual damit zeichnen.

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

Sie können die Schritte zum Erstellen und Hinzufügen der Farbstopps auch mithilfe dieser kürzeren Syntax zusammenfassen:

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

Animieren eines Radialverlaufpinsels

In diesem Beispiel wird gezeigt, wie Sie die Farbe des ersten Farbverlaufstopps eines Radialfarbpinsels animieren.

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

Hinweise

Mit diesem Pinsel wird ein SpriteVisual mit einem radialen Farbverlauf paints.

Der Farbverlauf wird in einer Ellipse gezeichnet, die durch die Eigenschaften EllipseCenter und EllipseRadius definiert wird. Farben für den Farbverlauf beginnen im Zentrum der Ellipse und enden am Radius.

Die Farben für den Radialfarbverlauf werden durch Farbstopps definiert. Jeder Farbstopp gibt eine Farbe und eine Position entlang des Farbverlaufs an.

Radialer Farbverlaufstopps

Eigenschaften

Name	Beschreibung
AnchorPoint	Ruft den Punkt auf dem Pinsel ab, der am Offset des Pinsels positioniert werden soll, oder legt diesen fest. (Geerbt von CompositionGradientBrush)
CenterPoint	Ruft den Punkt ab, an dem der Pinsel gedreht und skaliert wird, oder legt diesen fest. (Geerbt von CompositionGradientBrush)
ColorStops	Ruft die Farbverlaufsstopps des Pinsels ab. (Geerbt von CompositionGradientBrush)
Comment	Eine Zeichenfolge, die dem CompositionObject zugeordnet werden soll. (Geerbt von CompositionObject)
Compositor	Der Kompositor , der zum Erstellen dieses CompositionObjects verwendet wurde. (Geerbt von CompositionObject)
DispatcherQueue	Ruft den DispatcherQueue für das CompositionObject ab. (Geerbt von CompositionObject)
EllipseCenter	Ruft die zweidimensionalen Koordinaten der Mitte der Ellipse ab, die den Farbverlauf enthält, oder legt diese fest.
EllipseRadius	Ruft die Ellipse ab, die den Farbverlauf enthält, oder legt diese fest.
ExtendMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie der Farbverlauf außerhalb des Farbverlaufsvektors oder des Abstands des Pinsels gezeichnet werden soll. (Geerbt von CompositionGradientBrush)
GradientOriginOffset	Dient zum Abrufen oder Festlegen der zweidimensionalen Koordinaten des Ursprungs des Farbverlaufs.
ImplicitAnimations	Die Auflistung impliziter Animationen, die diesem Objekt zugeordnet sind. (Geerbt von CompositionObject)
InterpolationSpace	Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie die Farben des Farbverlaufs interpoliert werden. (Geerbt von CompositionGradientBrush)
MappingMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Positionierungskoordinaten des Farbverlaufspinsels (StartPoint, EndPoint) absolut oder relativ zum Ausgabebereich sind. (Geerbt von CompositionGradientBrush)
Offset	Dient zum Abrufen oder Festlegen des Offsets des Pinsels relativ zum zu bemalten Objekt. (Geerbt von CompositionGradientBrush)
Properties	Die Auflistung der Eigenschaften, die dem CompositionObject zugeordnet sind. (Geerbt von CompositionObject)
RotationAngle	Ruft den Drehwinkel des Pinsels in Bogenmaß ab oder legt den Drehwinkel fest. (Geerbt von CompositionGradientBrush)
RotationAngleInDegrees	Ruft den Drehwinkel des Pinsels in Grad ab oder legt den Drehwinkel fest. (Geerbt von CompositionGradientBrush)
Scale	Ruft die Skalierung ab, die auf den Pinsel angewendet werden soll, oder legt diese fest. (Geerbt von CompositionGradientBrush)
TransformMatrix	Ruft die Matrix der Transformationen ab, die auf den Pinsel angewendet werden sollen, oder legt diese fest. (Geerbt von CompositionGradientBrush)

Methoden

Name	Beschreibung
Close()	Schließt das CompositionObject und gibt Systemressourcen frei. (Geerbt von CompositionObject)
Dispose()	Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freigeben oder Zurücksetzen nicht verwalteter Ressourcen verknüpft sind. (Geerbt von CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Definiert eine Eigenschaft, die animiert werden kann. (Geerbt von CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Verbindet eine Animation mit der angegebenen Eigenschaft des Objekts und startet die Animation. (Geerbt von CompositionObject)
StartAnimation(String, CompositionAnimation)	Verbindet eine Animation mit der angegebenen Eigenschaft des Objekts und startet die Animation. (Geerbt von CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Startet eine Animationsgruppe. Mit der StartAnimationGroup-Methode auf CompositionObject können Sie CompositionAnimationGroup starten. Alle Animationen in der Gruppe werden gleichzeitig für das Objekt gestartet. (Geerbt von CompositionObject)
StopAnimation(String)	Trennt eine Animation von der angegebenen Eigenschaft und stoppt die Animation. (Geerbt von CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Beendet eine Animationsgruppe. (Geerbt von CompositionObject)
TryGetAnimationController(String)	Gibt einen AnimationController für die Animation zurück, die auf der angegebenen Eigenschaft ausgeführt wird. (Geerbt von CompositionObject)

Gilt für:

Weitere Informationen

Brush

Feedback

War diese Seite hilfreich?