RadialGradientBrush Classe

Définition

Espace de noms:

System.Windows.Media

Assembly:

PresentationCore.dll

Peint une zone avec un dégradé radial. Un point focal définit le début du dégradé, et un cercle définit le point de fin du dégradé.

public ref class RadialGradientBrush sealed : System::Windows::Media::GradientBrush

public sealed class RadialGradientBrush : System.Windows.Media.GradientBrush

type RadialGradientBrush = class
    inherit GradientBrush

Public NotInheritable Class RadialGradientBrush
Inherits GradientBrush

Héritage

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Brush

GradientBrush

RadialGradientBrush

Remarques

Le RadialGradientBrush modèle de programmation est similaire au modèle de programmation .LinearGradientBrush Toutefois, le dégradé linéaire a un point de départ et un point de terminaison pour définir le vecteur de dégradé, tandis que le dégradé radial a un cercle, ainsi qu’un point focal, pour définir le comportement du dégradé. Le cercle définit le point de terminaison du dégradé. En d’autres termes, un point de dégradé à 1,0 définit la couleur à la circonférence du cercle. Le point focal définit le centre du dégradé. Un point de dégradé à 0,0 définit la couleur au niveau du point focal.

L’image suivante montre un rectangle rempli d’un dégradé radial. Dégradé radial allant du blanc au gris. Le cercle extérieur représente le cercle dégradé tandis que le point rouge désigne le point focal. Ce dégradé a sa SpreadMethod valeur Pad.

Dégradé radial avec un point focal mis en surbrillance

Note

RadialGradientBrush les objets sont rendus à l’aide de l’accélération matérielle sur Tier 2 systèmes. Pour plus d’informations sur les niveaux matériels, consultez Les niveaux de rendu graphique.

Fonctionnalités gratuites

Étant donné qu’elle hérite de la Freezable classe, la RadialGradientBrush classe fournit plusieurs fonctionnalités spéciales : RadialGradientBrush les objets peuvent être déclarés en tant que ressources, partagés entre plusieurs objets, rendus en lecture seule pour améliorer les performances, clonés et mis en sécurité des threads. Pour plus d’informations sur les différentes fonctionnalités fournies par Freezable les objets, consultez La vue d’ensemble des objets freezables.

Constructeurs

Nom	Description
RadialGradientBrush()	Initialise une nouvelle instance de la classe RadialGradientBrush.
RadialGradientBrush(Color, Color)	Initialise une nouvelle instance de la RadialGradientBrush classe avec les couleurs de début et d’arrêt spécifiées.
RadialGradientBrush(GradientStopCollection)	Initialise une nouvelle instance de la RadialGradientBrush classe qui a les arrêts de dégradé spécifiés.

Champs

Nom	Description
CenterProperty	Identifie la Center propriété de dépendance.
GradientOriginProperty	Identifie la GradientOrigin propriété de dépendance.
RadiusXProperty	Identifie la RadiusX propriété de dépendance.
RadiusYProperty	Identifie la RadiusY propriété de dépendance.

Propriétés

Nom	Description
CanFreeze	Obtient une valeur qui indique si l’objet peut être rendu non modifiable. (Hérité de Freezable)
Center	Obtient ou définit le centre du cercle le plus extérieur du dégradé radial.
ColorInterpolationMode	Obtient ou définit une ColorInterpolationMode énumération qui spécifie la façon dont les couleurs du dégradé sont interpolées. (Hérité de GradientBrush)
DependencyObjectType	Obtient le DependencyObjectType type CLR de cette instance. (Hérité de DependencyObject)
Dispatcher	Obtient ce Dispatcher qui DispatcherObject est associé. (Hérité de DispatcherObject)
GradientOrigin	Obtient ou définit l’emplacement du point focal bidimensionnel qui définit le début du dégradé.
GradientStops	Obtient ou définit les arrêts de dégradé du pinceau. (Hérité de GradientBrush)
HasAnimatedProperties	Obtient une valeur qui indique si un ou plusieurs AnimationClock objets sont associés à l’une des propriétés de dépendance de cet objet. (Hérité de Animatable)
IsFrozen	Obtient une valeur qui indique si l’objet est actuellement modifiable. (Hérité de Freezable)
IsSealed	Obtient une valeur qui indique si cette instance est actuellement scellée (en lecture seule). (Hérité de DependencyObject)
MappingMode	Obtient ou définit une BrushMappingMode énumération qui spécifie si les coordonnées de positionnement du pinceau dégradé sont absolues ou relatives à la zone de sortie. (Hérité de GradientBrush)
Opacity	Obtient ou définit le degré d’opacité d’un Brush. (Hérité de Brush)
RadiusX	Obtient ou définit le rayon horizontal du cercle le plus extérieur du dégradé radial.
RadiusY	Obtient ou définit le rayon vertical du cercle le plus extérieur d’un dégradé radial.
RelativeTransform	Obtient ou définit la transformation appliquée au pinceau à l’aide de coordonnées relatives. (Hérité de Brush)
SpreadMethod	Obtient ou définit le type de méthode de propagation qui spécifie comment dessiner un dégradé qui commence ou se termine à l’intérieur des limites de l’objet à peindre. (Hérité de GradientBrush)
Transform	Obtient ou définit la transformation appliquée au pinceau. Cette transformation est appliquée une fois la sortie du pinceau mappée et positionnée. (Hérité de Brush)

Méthodes

Nom	Description
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Applique un AnimationClock à l’objet spécifié DependencyProperty. Si la propriété est déjà animée, la propriété HandoffBehavior spécifiée est utilisée. (Hérité de Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Applique un AnimationClock à l’objet spécifié DependencyProperty. Si la propriété est déjà animée, le comportement de SnapshotAndReplace transfert est utilisé. (Hérité de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Applique une animation au fichier spécifié DependencyProperty. L’animation est démarrée lorsque l’image suivante est rendue. Si la propriété spécifiée est déjà animée, celle-ci HandoffBehavior est utilisée. (Hérité de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Applique une animation au fichier spécifié DependencyProperty. L’animation est démarrée lorsque l’image suivante est rendue. Si la propriété spécifiée est déjà animée, le comportement de SnapshotAndReplace transfert est utilisé. (Hérité de Animatable)
CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject)
ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un DependencyProperty identificateur. (Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)	Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par un DependencyPropertyKey. (Hérité de DependencyObject)
Clone()	Crée un clone modifiable de ce RadialGradientBrushfichier, en effectuant des copies approfondies des valeurs de cet objet. Lors de la copie des propriétés de dépendance, cette méthode copie les références de ressources et les liaisons de données (mais elles peuvent ne plus être résolues), mais pas les animations ni leurs valeurs actuelles.
CloneCore(Freezable)	Rend l’instance un clone (copie approfondie) de la propriété de base (non animée) spécifiée Freezable . (Hérité de Freezable)
CloneCurrentValue()	Crée un clone modifiable de cet RadialGradientBrush objet, effectuant des copies approfondies des valeurs actuelles de cet objet. Les références de ressources, les liaisons de données et les animations ne sont pas copiées, mais leurs valeurs actuelles sont.
CloneCurrentValueCore(Freezable)	Rend l’instance un clone modifiable (copie approfondie) de l’élément spécifié Freezable à l’aide de valeurs de propriété actuelles. (Hérité de Freezable)
CoerceValue(DependencyProperty)	Force la valeur de la propriété de dépendance spécifiée. Pour ce faire, appelez n’importe quelle CoerceValueCallback fonction spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur l’appel DependencyObject. (Hérité de DependencyObject)
CreateInstance()	Initialise une nouvelle instance de la classe Freezable. (Hérité de Freezable)
CreateInstanceCore()	En cas d’implémentation dans une classe dérivée, crée une nouvelle instance de la Freezable classe dérivée. (Hérité de Freezable)
Equals(Object)	Détermine si un élément fourni DependencyObject est équivalent à l’actuel DependencyObject. (Hérité de DependencyObject)
Freeze()	Rend l’objet actuel non modifiable et définit sa IsFrozen propriété sur true. (Hérité de Freezable)
FreezeCore(Boolean)	Rend cet Animatable objet non modifiable ou détermine s’il peut être rendu inmodifiable. (Hérité de Animatable)
GetAnimationBaseValue(DependencyProperty)	Retourne la valeur non animée de l’objet spécifié DependencyProperty. (Hérité de Animatable)
GetAsFrozen()	Crée une copie figée des valeurs de Freezablepropriété de base (non animées). Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence. (Hérité de Freezable)
GetAsFrozenCore(Freezable)	Rend l’instance un clone figé de la propriété spécifiée à Freezable l’aide de valeurs de propriété de base (non animées). (Hérité de Freezable)
GetCurrentValueAsFrozen()	Crée une copie figée de l’utilisation Freezable des valeurs de propriété actuelles. Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence. (Hérité de Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Rend l’instance actuelle un clone figé du fichier spécifié Freezable. Si l’objet a des propriétés de dépendance animée, leurs valeurs animées actuelles sont copiées. (Hérité de Freezable)
GetHashCode()	Obtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject)
GetLocalValueEnumerator()	Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject. (Hérité de DependencyObject)
GetValue(DependencyProperty)	Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject. (Hérité de DependencyObject)
InvalidateProperty(DependencyProperty)	Évalue à nouveau la valeur effective de la propriété de dépendance spécifiée. (Hérité de DependencyObject)
OnChanged()	Appelé lorsque l’objet actuel Freezable est modifié. (Hérité de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Ce membre prend en charge l’infrastructure Windows Presentation Foundation (WPF) et n’est pas destiné à être utilisé directement à partir de votre code. (Hérité de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Garantit que les pointeurs de contexte appropriés sont établis pour un DependencyObjectType membre de données qui vient d’être défini. (Hérité de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Remplace l’implémentation DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) l’appel de tous Changed les gestionnaires en réponse à une propriété de dépendance modifiée de type Freezable. (Hérité de Freezable)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, le cas échéant. (Hérité de DependencyObject)
ReadPreamble()	Garantit l’accès Freezable à partir d’un thread valide. Les héritiers de Freezable doivent appeler cette méthode au début de toute API qui lit les membres de données qui ne sont pas des propriétés de dépendance. (Hérité de Freezable)
SetCurrentValue(DependencyProperty, Object)	Définit la valeur d’une propriété de dépendance sans modifier sa source de valeur. (Hérité de DependencyObject)
SetValue(DependencyProperty, Object)	Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance. (Hérité de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance. (Hérité de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie. (Hérité de DependencyObject)
ToString()	Retourne la représentation sous forme de chaîne de ce Brush. (Hérité de Brush)
ToString(IFormatProvider)	Crée une représentation sous forme de chaîne de cet objet en fonction des informations de mise en forme spécifiques à la culture spécifiées. (Hérité de Brush)
VerifyAccess()	Applique que le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject)
WritePostscript()	Déclenche l’événement Changed pour la Freezable méthode et appelle sa OnChanged() méthode. Les classes dérivées Freezable de doivent appeler cette méthode à la fin de toute API qui modifie les membres de classe qui ne sont pas stockés en tant que propriétés de dépendance. (Hérité de Freezable)
WritePreamble()	Vérifie que l’objet Freezable n’est pas figé et qu’il est accessible à partir d’un contexte de threading valide. Freezable Les hériteurs doivent appeler cette méthode au début de toute API qui écrit dans les membres de données qui ne sont pas des propriétés de dépendance. (Hérité de Freezable)

Événements

Nom	Description
Changed	Se produit lorsque l’objet Freezable qu’il contient est modifié. (Hérité de Freezable)

Implémentations d’interfaces explicites

Nom	Description
IFormattable.ToString(String, IFormatProvider)	Met en forme la valeur de l’instance actuelle à l’aide du format spécifié. (Hérité de Brush)

Voir aussi

• GradientStop
• GradientBrush
• LinearGradientBrush