Partager via


CompositionRadialGradientBrush Classe

Définition

Représente un pinceau qui peint une zone avec un dégradé radial.

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
Héritage
Object Platform::Object IInspectable CompositionObject CompositionBrush CompositionGradientBrush CompositionRadialGradientBrush
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10, version 1903 (introduit dans 10.0.18362.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v8.0)

Exemples

Créer un pinceau dégradé radial

Cet exemple montre comment créer un pinceau dégradé radial, ajouter 2 taquets de couleur et peindre un SpriteVisual avec celui-ci.

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

Vous pouvez également condenser les étapes de création et d’ajout des arrêts de couleur à l’aide de cette syntaxe plus courte :

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

Animer un pinceau dégradé radial

Cet exemple montre comment animer la couleur du premier point de dégradé d’un pinceau dégradé radial.

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

Remarques

Ce pinceau peint un SpriteVisual avec un dégradé radial.

Le dégradé est dessiné dans une ellipse définie par les propriétés EllipseCenter et EllipseRadius . Les couleurs du début du dégradé se trouvent au centre de l’ellipse et se terminent au niveau du rayon.

Les couleurs du dégradé radial sont définies par des taquets de couleur. Chaque arrêt de couleur spécifie une couleur et un emplacement le long du dégradé.

Taquets de couleur de dégradé radial

Propriétés

AnchorPoint

Obtient ou définit le point sur le pinceau à positionner au décalage du pinceau.

(Hérité de CompositionGradientBrush)
CenterPoint

Obtient ou définit le point sur lequel le pinceau est pivoté et mis à l’échelle.

(Hérité de CompositionGradientBrush)
ColorStops

Obtient les points de dégradé du pinceau.

(Hérité de CompositionGradientBrush)
Comment

Chaîne à associer à l’objet CompositionObject.

(Hérité de CompositionObject)
Compositor

Compositeur utilisé pour créer cet Objet CompositionObject.

(Hérité de CompositionObject)
Dispatcher

Répartiteur de l’objet CompositionObject.

(Hérité de CompositionObject)
DispatcherQueue

Obtient dispatcherQueue pour compostionObject.

(Hérité de CompositionObject)
EllipseCenter

Obtient ou définit les coordonnées à deux dimensions du centre de l’ellipse qui contient le dégradé.

EllipseRadius

Obtient ou définit le rayon de l’ellipse qui contient le dégradé.

ExtendMode

Obtient ou définit une valeur qui spécifie comment dessiner le dégradé en dehors du vecteur ou de l’espace de dégradé du pinceau.

(Hérité de CompositionGradientBrush)
GradientOriginOffset

Obtient ou définit les coordonnées à deux dimensions de l’origine du dégradé.

ImplicitAnimations

Collection d’animations implicites attachées à cet objet.

(Hérité de CompositionObject)
InterpolationSpace

Obtient ou définit une valeur qui spécifie la façon dont les couleurs du dégradé sont interpolées.

(Hérité de CompositionGradientBrush)
MappingMode

Obtient ou définit une valeur qui indique si les coordonnées de positionnement du pinceau dégradé (StartPoint, EndPoint) sont absolues ou relatives à la zone de sortie.

(Hérité de CompositionGradientBrush)
Offset

Obtient ou définit le décalage du pinceau par rapport à l’objet peint.

(Hérité de CompositionGradientBrush)
Properties

Collection de propriétés associées à CompositionObject.

(Hérité de CompositionObject)
RotationAngle

Obtient ou définit l’angle de rotation du pinceau en radians.

(Hérité de CompositionGradientBrush)
RotationAngleInDegrees

Obtient ou définit l’angle de rotation du pinceau en degrés.

(Hérité de CompositionGradientBrush)
Scale

Obtient ou définit l’échelle à appliquer au pinceau.

(Hérité de CompositionGradientBrush)
TransformMatrix

Obtient ou définit la matrice des transformations à appliquer au pinceau.

(Hérité de CompositionGradientBrush)

Méthodes

Close()

Ferme l’objet CompositionObject et libère les ressources système.

(Hérité de CompositionObject)
ConnectAnimation(String, CompositionAnimation)

Se connecte et animation.

(Hérité de CompositionObject)
DisconnectAnimation(String)

Déconnecte une animation.

(Hérité de CompositionObject)
Dispose()

Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.

(Hérité de CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)

Définit une propriété qui peut être animée.

(Hérité de CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)

Connecte une animation avec la propriété spécifiée de l’objet et démarre l’animation.

(Hérité de CompositionObject)
StartAnimation(String, CompositionAnimation)

Connecte une animation avec la propriété spécifiée de l’objet et démarre l’animation.

(Hérité de CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)

Démarre un groupe d’animations.

La méthode StartAnimationGroup sur CompositionObject vous permet de démarrer CompositionAnimationGroup. Toutes les animations du groupe sont démarrées en même temps sur l’objet .

(Hérité de CompositionObject)
StopAnimation(String)

Déconnecte une animation de la propriété spécifiée et arrête l’animation.

(Hérité de CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)

Arrête un groupe d’animations.

(Hérité de CompositionObject)
TryGetAnimationController(String)

Renvoie un AnimationController pour l’animation en cours d’exécution sur la propriété spécifiée.

(Hérité de CompositionObject)

S’applique à

Voir aussi