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

SolidColorBrush, classe

.NET Framework 4

Autres versions

Peint une zone avec une couleur unie.

Hiérarchie d'héritage

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

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

Syntaxe

C++

Copier

public sealed class SolidColorBrush : Brush

Utilisation des éléments objets XAML

Copier

<SolidColorBrush .../>

Utilisation des attributs XAML

Copier

<object property="predefinedBrushName"/>
- or -
<object property="#rgb"/>
- or -
<object property="#argb"/>
- or -
<object property="#rrggbb"/>
- or -
<object property="#aarrggbb"/>
- or -
<object property="sc#scA,scR,scG,scB"/>
- or -
<object property="ContextColor profileUri alphaValue,colorValue"/>

Valeurs XAML

predefinedBrushName

Nom d'un pinceau défini par la classe Brushes (Blue ou Orange, par exemple).

rgb

Nombre hexadécimal à trois chiffres qui décrit le Color de ce pinceau. Le premier chiffre spécifie la valeur R de la couleur, le deuxième spécifie la valeur G, et le troisième spécifie la valeur B. Par exemple, 00F.

arvb

Nombre hexadécimal à quatre chiffres qui décrit le Color de ce pinceau. Le premier chiffre spécifie la valeur A de la couleur, le deuxième spécifie sa valeur R, le suivant spécifie la valeur G, et le dernier spécifie sa valeur B. Par exemple, F00F.

rrggbb

Nombre hexadécimal à six chiffres qui décrit le Color de ce pinceau. Les deux premiers chiffres spécifient la valeur R de la couleur, les deux suivants spécifient sa valeur G, et les deux derniers spécifient sa valeur B. Par exemple, 0000FF.

aarrggbb

Nombre hexadécimal à huit chiffres qui décrit le Color de ce pinceau. Les deux premiers chiffres spécifient la valeur A de la couleur, les deux suivants spécifient sa valeur R, les deux suivants spécifient sa valeur G et les deux derniers spécifient sa valeur B. Par exemple, FF0000FF.

scA

Single

Valeur ScA du Color de ce pinceau.

scR

Single

Valeur ScR du Color de ce pinceau.

scG

Single

Valeur ScG du Color de ce pinceau.

scB

Single

Valeur ScB du Color de ce pinceau.

profileUri

System.Uri

Profil de couleurs International Color Consortium (ICC) ou Image Color Management (ICM).

alphaValue

System.Single

Valeur de couleur de canal alpha. La plage de valeurs s'étend de 0,0 à 1,0.

colorValue

Une liste délimitée par des virgules de trois à huit valeurs qui représentent les canaux de couleurs du profil chromatique. La plage de valeurs s'étend de 0,0 à 1,0.

Le type SolidColorBrush expose les membres suivants.

Constructeurs

	Nom	Description
	SolidColorBrush()	Initialise une nouvelle instance de la classe SolidColorBrush sans couleur ni animation.
	SolidColorBrush(Color)	Initialise une nouvelle instance de la classe SolidColorBrush avec le Color spécifié.

Début

Propriétés

	Nom	Description
	CanFreeze	Obtient une valeur qui indique la possibilité ou non de rendre un objet non modifiable. (Hérité de Freezable.)
	Color	Obtient ou définit la couleur de ce SolidColorBrush.
	DependencyObjectType	Obtient le DependencyObjectType qui encapsule le type CLR de cette instance. (Hérité de DependencyObject.)
	Dispatcher	Obtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject.)
	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.)
	IsFrozen	Obtient une valeur qui indique si l'objet est actuellement modifiable ou pas. (Hérité de Freezable.)
	IsSealed	Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule). (Hérité de DependencyObject.)
	Opacity	Obtient ou définit le degré d'opacité d'un Brush. (Hérité de Brush.)
	RelativeTransform	Obtient ou définit la transformation appliquée au pinceau à l'aide de coordonnées relatives. (Hérité de Brush.)
	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. (Hérité de Brush.)

Début

Méthodes

	Nom	Description
	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.)
	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.)
	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.)
	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.)
	CheckAccess	Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject.)
	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.)
	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.)
	Clone	Crée un clone modifiable de ce SolidColorBrush, 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.
	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.)
	CloneCurrentValue	Crée un clone modifiable de cet objet SolidColorBrush, en créant des copies complètes 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.
	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.)
	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.)
	CreateInstance	Initialise une nouvelle instance de la classe Freezable. (Hérité de Freezable.)
	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.)
	DeserializeFrom	Ce membre prend en charge l'infrastructure WPF et n'est pas conçu pour être utilisé directement à partir du code.
	Equals	Détermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Hérité de DependencyObject.)
	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.)
	Freeze()	Rend l'objet actuel non modifiable et définit sa propriété IsFrozen sur true. (Hérité de Freezable.)
	FreezeCore	Rend cet objet Animatable non modifiable ou détermine s'il peut être rendu non modifiable. (Hérité de Animatable.)
	GetAnimationBaseValue	Retourne la valeur non animée de la propriété DependencyProperty spécifiée. (Hérité de Animatable.)
	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.)
	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.)
	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.)
	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.)
	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.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	GetValue	Retourne la valeur effective actuelle d'une propriété de dépendance sur cette instance d'un DependencyObject. (Hérité de DependencyObject.)
	InvalidateProperty	Réévalue la valeur effective pour la propriété de dépendance spécifiée (Hérité de DependencyObject.)
	MemberwiseClone	Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
	OnChanged	Appelé lors de la modification de l'objet Freezable actuel. (Hérité de Freezable.)
	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.)
	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.)
	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.)
	ReadLocalValue	Retourne la valeur de proximité d'une propriété de dépendance, si elle existe. (Hérité de DependencyObject.)
	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.)
	SetCurrentValue	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 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.)
	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.)
	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.)
	ToString()	Retourne une 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 selon les informations de mise en forme spécifique à la culture spécifiées. (Hérité de Brush.)
	VerifyAccess	Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject.)
	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.)
	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

Événements

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

Début

Champs

	Nom	Description
	ColorProperty	Identifie la propriété de dépendance Color.

Début

Implémentations d'interface explicite

	Nom	Description
	IFormattable.ToString	Met en forme la valeur de l'instance en cours à l'aide du format spécifié. (Hérité de Brush.)

Début

Notes

Pour des raisons pratiques, la classe Brushes propose un ensemble d'objets SolidColorBrush communément utilisés, tels que Blue et Yellow.

Fonctionnalités Freezable : dans la mesure où elle hérite de la classe Freezable, la classe SolidColorBrush propose plusieurs fonctionnalités spéciales : les objets SolidColorBrush peuvent être déclarés en tant que ressources, partagés entre plusieurs objets, définis en lecture seule pour améliorer les performances, clonés et thread-safe. Pour plus d'informations sur les différentes fonctionnalités fournies par les objets Freezable, consultez Vue d'ensemble des objets Freezable.

Informations de version

.NET Framework

Pris en charge dans : 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Plateformes

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.

Sécurité des threads

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.

Voir aussi

Référence

System.Windows.Media, espace de noms

Brush

Brushes

Autres ressources

Vue d'ensemble de la peinture avec des couleurs unies ou des dégradés

Pinceaux, exemple

Vue d'ensemble des objets Freezable

Cela vous a-t-il été utile ? Oui Non

Manque de précision

Pas suffisamment approfondi

Besoin d'exemples de code supplémentaires

La traduction a besoin d'être améliorée.

(1500 caractères restants)

Contenu de la communauté Ajouter

FAQ