Accueil Library Formation Téléchargements Support technique Communauté
Connexion | United States - English | |
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

Brush, classe

.NET Framework 4

Définit les objets utilisés pour peindre des objets graphiques. Les classes qui dérivent de Brush décrivent comment la zone est peinte.

System.Object
  System.Windows.Threading.DispatcherObject
    System.Windows.DependencyObject
      System.Windows.Freezable
        System.Windows.Media.Animation.Animatable
          System.Windows.Media.Brush
            System.Windows.Media.BitmapCacheBrush
            System.Windows.Media.GradientBrush
            System.Windows.Media.SolidColorBrush
            System.Windows.Media.TileBrush

Espace de noms :  System.Windows.Media
Assembly :  PresentationCore (dans PresentationCore.dll)
XMLNS pour XAML : http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
C#
C++
F#
VB
Copier 
[LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable)]
[TypeConverterAttribute(typeof(BrushConverter))]
public abstract class Brush : Animatable, 
	IFormattable
XAML
Copier 
Pour plus d'informations sur XAML, consultez la section Notes.

Le type Brush expose les membres suivants.

  Nom Description
Méthode protégée Brush Initialise une nouvelle instance de la classe Brush.
Début
  Nom Description
Propriété publique CanFreeze Obtient une valeur qui indique la possibilité ou non de rendre un objet non modifiable. (Hérité de Freezable.)
Propriété publique DependencyObjectType Obtient le DependencyObjectType qui encapsule le type CLR de cette instance.  (Hérité de DependencyObject.)
Propriété publique Dispatcher Obtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject.)
Propriété publique HasAnimatedProperties Obtient une valeur qui indique si un ou plusieurs objets AnimationClock sont associés à l'une ou l'autre des propriétés de dépendance de cet objet. (Hérité de Animatable.)
Propriété publique IsFrozen Obtient une valeur qui indique si l'objet est actuellement modifiable ou pas. (Hérité de Freezable.)
Propriété publique IsSealed Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule). (Hérité de DependencyObject.)
Propriété publique Opacity Obtient ou définit le degré d'opacité d'un Brush.
Propriété publique RelativeTransform Obtient ou définit la transformation appliquée au pinceau à l'aide de coordonnées relatives.
Propriété publique Transform Obtient ou définit la transformation qui est appliquée au pinceau. Cette transformation est appliquée une fois la sortie du pinceau mappée et positionnée.
Début
  Nom Description
Méthode publique ApplyAnimationClock(DependencyProperty, AnimationClock) Applique une horloge AnimationClock à la propriété DependencyProperty spécifiée. Si la propriété est déjà animée, le comportement de transfert SnapshotAndReplace est utilisé. (Hérité de Animatable.)
Méthode publique ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) Applique une horloge AnimationClock à la propriété DependencyProperty spécifiée. Si la propriété spécifiée est déjà animée, le comportement HandoffBehavior spécifié est utilisé. (Hérité de Animatable.)
Méthode publique BeginAnimation(DependencyProperty, AnimationTimeline) Applique une animation à la propriété DependencyPropertyspécifiée. L'animation est démarrée à la restitution de l'image suivante. Si la propriété spécifiée est déjà animée, le comportement de transfert SnapshotAndReplace est utilisé. (Hérité de Animatable.)
Méthode publique BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) Applique une animation à la propriété DependencyPropertyspécifiée. L'animation est démarrée à la restitution de l'image suivante. Si la propriété spécifiée est déjà animée, le comportement HandoffBehavior spécifié est utilisé. (Hérité de Animatable.)
Méthode publique CheckAccess Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject.)
Méthode publique ClearValue(DependencyProperty) Efface la valeur de proximité d'une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty. (Hérité de DependencyObject.)
Méthode publique ClearValue(DependencyPropertyKey) Efface la valeur de proximité d'une propriété en lecture seule. La propriété à effacer est spécifiée par un DependencyPropertyKey. (Hérité de DependencyObject.)
Méthode publique Clone Crée un clone modifiable de ce Brush, en copiant toutes les valeurs de cet objet. Lors de la copie de propriétés de dépendance, cette méthode copie les références de ressources et les liaisons de données (même si elles ne peuvent plus être résolues), mais pas les animations ni leurs valeurs actuelles.
Méthode protégée CloneCore Convertit l'instance en clone (copie complète) du Freezable spécifié à l'aide des valeurs de propriétés (non-animées) de base. (Hérité de Freezable.)
Méthode publique CloneCurrentValue Crée un clone modifiable de cet objet Brush, en effectuant une copie complète des valeurs actuelles de cet objet. Contrairement à leurs valeurs actuelles, les références de ressources, les liaisons de données et les animations ne sont pas copiées.
Méthode protégée CloneCurrentValueCore Convertit l'instance en clone modifiable (copie complète) du Freezable spécifié à l'aide des valeurs de propriétés actuelles. (Hérité de Freezable.)
Méthode publique CoerceValue Force la valeur de la propriété de dépendance spécifiée. Cette opération est accomplie en appelant toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance comme elle existe sur le DependencyObject appelant. (Hérité de DependencyObject.)
Méthode protégée CreateInstance Initialise une nouvelle instance de la classe Freezable. (Hérité de Freezable.)
Méthode protégée CreateInstanceCore Une fois implémentée dans une classe dérivée, initialise une nouvelle instance de la classe dérivée Freezable. (Hérité de Freezable.)
Méthode publique Equals Détermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Hérité de DependencyObject.)
Méthode protégée Finalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publique Freeze() Rend l'objet actuel non modifiable et définit sa propriété IsFrozen sur true. (Hérité de Freezable.)
Méthode protégée FreezeCore Rend cet objet Animatable non modifiable ou détermine s'il peut être rendu non modifiable. (Hérité de Animatable.)
Méthode publique GetAnimationBaseValue Retourne la valeur non animée de la propriété DependencyProperty spécifiée. (Hérité de Animatable.)
Méthode publique GetAsFrozen Crée une copie figée de Freezable, à l'aide des valeurs de propriété (non-animées) de base. É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.)
Méthode protégée GetAsFrozenCore Convertit l'instance en clone figé du Freezable spécifié à l'aide des valeurs de propriétés (non-animées) de base. (Hérité de Freezable.)
Méthode publique GetCurrentValueAsFrozen Crée une copie figée de Freezable à l'aide 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.)
Méthode protégée GetCurrentValueAsFrozenCore Convertit l'instance actuelle en un clone figé du Freezable spécifié. Si l'objet comporte des propriétés de dépendance animées, leurs valeurs animées actuelles sont copiées. (Hérité de Freezable.)
Méthode publique GetHashCode Obtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject.)
Méthode publique 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.)
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publique GetValue Retourne la valeur effective actuelle d'une propriété de dépendance sur cette instance d'un DependencyObject. (Hérité de DependencyObject.)
Méthode publique InvalidateProperty Réévalue la valeur effective pour la propriété de dépendance spécifiée (Hérité de DependencyObject.)
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode protégée OnChanged Appelé lors de la modification de l'objet Freezable actuel. (Hérité de Freezable.)
Méthode protégée OnFreezablePropertyChanged(DependencyObject, DependencyObject) Garantit que les pointeurs de contexte appropriés sont établis pour un membre de données de type DependencyObjectType qui vient juste d'être défini. (Hérité de Freezable.)
Méthode protégée OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) Ce membre prend en charge l'infrastructure Windows Presentation Foundation (WPF) et n'est pas conçu pour être utilisé directement à partir du code. (Hérité de Freezable.)
Méthode protégée OnPropertyChanged Substitue l'implémentation DependencyObject de OnPropertyChanged pour appeler également tous les gestionnaires Changed en réponse à une propriété de dépendance variable de type Freezable. (Hérité de Freezable.)
Méthode publique ReadLocalValue Retourne la valeur de proximité d'une propriété de dépendance, si elle existe. (Hérité de DependencyObject.)
Méthode protégée ReadPreamble Garantit que Freezable est accessible à partir d'un thread valide. Les héritiers de Freezable doivent appeler cette méthode au début de toute API lisant les membres de données qui ne sont pas des propriétés de dépendance. (Hérité de Freezable.)
Méthode publique SetCurrentValue Définit la valeur d'une propriété de dépendance sans modifier sa source de valeur. (Hérité de DependencyObject.)
Méthode publique SetValue(DependencyProperty, Object) Définit la valeur de proximité d'une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance. (Hérité de DependencyObject.)
Méthode publique SetValue(DependencyPropertyKey, Object) Définit la valeur de proximité 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.)
Méthode protégée ShouldSerializeProperty Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur pour la propriété de dépendance fournie. (Hérité de DependencyObject.)
Méthode publique ToString() Retourne une représentation sous forme de chaîne de ce Brush. (Substitue Object.ToString().)
Méthode publique ToString(IFormatProvider) Crée une représentation sous forme de chaîne de cet objet selon les informations de mise en forme spécifique à la culture spécifiées.
Méthode publique VerifyAccess Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject.)
Méthode protégée WritePostscript Déclenche l'événement Changed pour Freezable et appelle sa méthode OnChanged. Les classes qui dérivent de Freezable doivent appeler cette méthode à la fin de toute API qui modifie des membres de classe non stockés en tant que propriétés de dépendance. (Hérité de Freezable.)
Méthode protégée WritePreamble Vérifie que le Freezable n'est pas figé et que son accès s'effectue à partir d'un contexte de thread valide. Les héritiers de Freezable doivent appeler cette méthode au début de toute API écrivant les membres de données qui ne sont pas des propriétés de dépendance. (Hérité de Freezable.)
Début
  Nom Description
Événement public Changed Se produit lorsque Freezable ou un objet qu'il contient est modifié. (Hérité de Freezable.)
Début
  Nom Description
Champ public Membre statique OpacityProperty Identifie la propriété de dépendance Opacity.
Champ public Membre statique RelativeTransformProperty Identifie la propriété de dépendance RelativeTransform.
Champ public Membre statique TransformProperty Identifie la propriété de dépendance Transform.
Début
  Nom Description
Implémentation d'interface explicite Méthode privée IFormattable.ToString Met en forme la valeur de l'instance en cours à l'aide du format spécifié.
Début

Un Brush « peint » ou « remplit » une zone avec sa sortie. Les différents pinceaux ont différents types de sortie. Certains peignent une zone avec une couleur unie, d'autres avec un dégradé, un modèle, une image ou un dessin. Les différents types de pinceaux WPF sont décrits dans la liste suivante :

  • SolidColorBrush : peint une zone avec un Color uni.

  • LinearGradientBrush : peint une zone avec un dégradé linéaire.

  • RadialGradientBrush : peint une zone avec un dégradé radial.

  • ImageBrush : peint une zone avec une image (représentée par un objet ImageSource).

  • DrawingBrush : peint une zone avec un Drawing. Le dessin peut inclure des objets de bitmap et de vecteur.

  • VisualBrush : peint une zone avec un objet Visual. VisualBrush vous permet de dupliquer le contenu d'une partie de votre application dans une autre zone, ce qui s'avère très utile pour créer des effets de réflexion et agrandir des parties de l'écran.

Pinceaux prédéfinis

Utilisez la classe Brushes pour peindre un objet à l'aide d'une couleur unie prédéfinie (AliceBlue ou Red, par exemple).

Pinceaux en XAML

Les différents types de Brush pouvant être utilisés en XAML, ainsi que la syntaxe qu'ils prennent en charge, sont répertoriés dans le tableau ci-dessous. Pour plus d'informations sur la syntaxe d'un pinceau spécifique, consultez la page correspondant au type de ce pinceau.

Classe

Syntaxe d'attribut

Syntaxe des éléments objet

SolidColorBrush

Oui

Oui

DrawingBrush

Non

Oui

ImageBrush

Non

Oui

LinearGradientBrush

Non

Oui

RadialGradientBrush

Non

Oui

VisualBrush

Non

Oui

Pour obtenir un exemple qui montre comment peindre rapidement une zone avec une couleur unie, consultez Comment : peindre une zone avec une couleur unie.

Fonctionnalités Freezable

Un pinceau est un type d'objet Freezable. Pour plus d'informations sur les fonctionnalités Freezable, telles que le gel et le clonage, consultez Vue d'ensemble des objets Freezable.

Remarques à l'attention des héritiers

Lorsque vous héritez de la classe Brush, vous devez substituer la méthode CreateInstanceCore. Selon que la classe doit effectuer un travail d'initialisation supplémentaire ou contient des membres de données de propriétés de non-dépendance, vous pouvez être amené à substituer d'autres méthodes Freezable. Pour plus d'informations sur l'héritage de types Freezable, consultez Vue d'ensemble des objets Freezable.

.NET Framework

Pris en charge dans : 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Référence

System.Windows.Media, espace de noms
[http://go.microsoft.com/fwlink/?LinkID=<codeEntityReferenceautoUpgrade="true">T:System.Windows.Media.Brushes]

Autres ressources

Vue d'ensemble de la peinture avec des couleurs unies ou des dégradés
Peinture avec des objets d'image, de dessin et visuels
Vue d'ensemble des objets Freezable
Cela vous a-t-il été utile ?
(1500 caractères restants)
Contenu de la communauté Ajouter
Annotations FAQ
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Confidentialité