CompositionRadialGradientBrush Classe

Riferimento

Definizione

Spazio dei nomi:: Microsoft.UI.Composition

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Rappresenta un pennello che disegna un'area con una sfumatura radiale.

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

Ereditarietà: Object Platform::Object IInspectable CompositionObject CompositionBrush CompositionGradientBrush CompositionRadialGradientBrush

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Esempio

Creare un pennello sfumatura radiale

In questo esempio viene illustrato come creare un pennello sfumatura radiale, aggiungere 2 punti di colore e disegnare uno SpriteVisual con esso.

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

È anche possibile condensare i passaggi per creare e aggiungere il colore arresta usando questa sintassi più breve:

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

Animare un pennello sfumatura radiale

In questo esempio viene illustrato come animare il colore del primo stop sfumatura di un pennello sfumatura radiale.

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

Commenti

Questo pennello disegna uno SpriteVisual con una sfumatura radiale.

La sfumatura viene disegnata all'interno di un'ellisse definita dalle proprietà EllipseCenter e EllipseRadius . I colori della sfumatura iniziano al centro dell'ellisse e terminano in corrispondenza del raggio.

I colori per la sfumatura radiale sono definiti da arresti di colore. Ogni stop di colore specifica un colore e una posizione lungo la sfumatura.

Il colore sfumatura radiale si arresta

Proprietà

AnchorPoint	Ottiene o imposta il punto sul pennello da posizionare all'offset del pennello. (Ereditato da CompositionGradientBrush)
CenterPoint	Ottiene o imposta il punto su cui il pennello viene ruotato e ridimensionato. (Ereditato da CompositionGradientBrush)
ColorStops	Ottiene l'arresto della sfumatura del pennello. (Ereditato da CompositionGradientBrush)
Comment	Stringa da associare a CompositionObject. (Ereditato da CompositionObject)
Compositor	Compositore usato per creare questo oggetto CompositionObject. (Ereditato da CompositionObject)
DispatcherQueue	Ottiene DispatcherQueue per CompositionObject. (Ereditato da CompositionObject)
EllipseCenter	Ottiene o imposta le coordinate bidimensionali del centro dell'ellisse contenente la sfumatura.
EllipseRadius	Ottiene o imposta i raggi dell'ellisse che contiene la sfumatura.
ExtendMode	Ottiene o imposta un valore che specifica come disegnare la sfumatura all'esterno del vettore o dello spazio sfumatura del pennello. (Ereditato da CompositionGradientBrush)
GradientOriginOffset	Ottiene o imposta le coordinate bidimensionali dell'origine della sfumatura.
ImplicitAnimations	Raccolta di animazioni implicite associate a questo oggetto. (Ereditato da CompositionObject)
InterpolationSpace	Ottiene o imposta un valore che specifica come vengono interpolati i colori della sfumatura. (Ereditato da CompositionGradientBrush)
MappingMode	Ottiene o imposta un valore che indica se le coordinate di posizionamento del pennello sfumatura (StartPoint, EndPoint) sono assolute o relative all'area di output. (Ereditato da CompositionGradientBrush)
Offset	Ottiene o imposta l'offset del pennello rispetto all'oggetto dipinto. (Ereditato da CompositionGradientBrush)
Properties	Raccolta di proprietà associate a CompositionObject. (Ereditato da CompositionObject)
RotationAngle	Ottiene o imposta l'angolo di rotazione del pennello nei radianti. (Ereditato da CompositionGradientBrush)
RotationAngleInDegrees	Ottiene o imposta l'angolo di rotazione del pennello in gradi. (Ereditato da CompositionGradientBrush)
Scale	Ottiene o imposta la scala da applicare al pennello. (Ereditato da CompositionGradientBrush)
TransformMatrix	Ottiene o imposta la matrice di trasformazioni da applicare al pennello. (Ereditato da CompositionGradientBrush)

Metodi

Close()	Chiude l'oggetto CompositionObject e rilascia le risorse di sistema. (Ereditato da CompositionObject)
Dispose()	Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite. (Ereditato da CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Definisce una proprietà che può essere animata. (Ereditato da CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Connette un'animazione con la proprietà specificata dell'oggetto e avvia l'animazione. (Ereditato da CompositionObject)
StartAnimation(String, CompositionAnimation)	Connette un'animazione con la proprietà specificata dell'oggetto e avvia l'animazione. (Ereditato da CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Avvia un gruppo di animazioni. Il metodo StartAnimationGroup in CompositionObject consente di avviare CompositionAnimationGroup. Tutte le animazioni del gruppo verranno avviate contemporaneamente sull'oggetto. (Ereditato da CompositionObject)
StopAnimation(String)	Disconnette un'animazione dalla proprietà specificata e arresta l'animazione. (Ereditato da CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Arresta un gruppo di animazioni. (Ereditato da CompositionObject)
TryGetAnimationController(String)	Restituisce un oggetto AnimationController per l'animazione in esecuzione nella proprietà specificata. (Ereditato da CompositionObject)

Si applica a

Vedi anche

Brush

Condividi tramite