Color Structure

Définition

Espace de noms:

System.Windows.Media

Assembly:

PresentationCore.dll

Décrit une couleur en termes de canaux alpha, rouge, vert et bleu.

public value class Color : IEquatable<System::Windows::Media::Color>, IFormattable

[System.ComponentModel.TypeConverter(typeof(System.Windows.Media.ColorConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public struct Color : IEquatable<System.Windows.Media.Color>, IFormattable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Media.ColorConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type Color = struct
    interface IFormattable

Public Structure Color
Implements IEquatable(Of Color), IFormattable

Héritage

Object

ValueType

Color

Attributs

TypeConverterAttribute LocalizabilityAttribute

Implémente

IEquatable<Color> IFormattable

Exemples

Cet exemple montre comment utiliser sRGB, ScRGB et les valeurs de profil de couleur pour créer la couleur bleue.

<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" >
<StackPanel Margin="20">
  
  <!-- This rectangle fill uses a Color with ScRGB values to
       create a completely opaque blue. -->
  <Rectangle Width="50" Height="50"  Margin="10">
     <Rectangle.Fill>
       <SolidColorBrush>
         <SolidColorBrush.Color>

           <!-- Describes the brush's color using
                ScRGB values. Each value has a range of 0-1.  -->
           <Color ScA="1.0" ScR="0.0" ScG="0.0" ScB="1.0" />
        </SolidColorBrush.Color>
      </SolidColorBrush>
    </Rectangle.Fill>
  </Rectangle>

  <!-- This rectangle fill uses a Color with sRGB values to
       create a completely opaque blue. -->
  <Rectangle Width="50" Height="50"  Margin="10">
     <Rectangle.Fill>
       <SolidColorBrush>
         <SolidColorBrush.Color>

           <!-- Describes the brush's color using
                sRGB values. Each value is a byte with range of 0-255.  -->
           <Color A="255" R="0" G="0" B="255" />
        </SolidColorBrush.Color>
      </SolidColorBrush>
    </Rectangle.Fill>
  </Rectangle>

  <!-- This rectangle fill uses the sRGB color profile and values to
       create a complete opaque blue. -->
  <Rectangle Width="50" Height="50"  Margin="10">
    <Rectangle.Fill>
      <SolidColorBrush Color="ContextColor 
       file://C:/WINDOWS/system32/spool/drivers/color/sRGB%20Color%20Space%20Profile.icm
       1.0,0.0,0.0,1.0"/>
    </Rectangle.Fill>
  </Rectangle>

</StackPanel>
</Page>

Remarques

Utilisation d'attributs XAML

<object property="predefinedColor"/>  
- 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

prédéfiniColor
Une des couleurs prédéfinies par la Colors classe.

Rvb
Nombre hexadécimal à trois chiffres. Le premier chiffre spécifie la valeur de R la couleur, le deuxième chiffre spécifie la G valeur et le troisième chiffre spécifie la B valeur. Par exemple : 00F.

Argb
Nombre hexadécimal à quatre chiffres. Le premier chiffre spécifie la valeur de A la couleur, le deuxième chiffre spécifie sa R valeur, le chiffre suivant spécifie la G valeur et le chiffre final spécifie sa B valeur. Par exemple : F00F.

rrggbb
Nombre hexadécimal à six chiffres. Les deux premiers chiffres spécifient la valeur de R la couleur, les deux suivantes spécifient sa G valeur et les deux derniers spécifient sa B valeur. Par exemple : 0000FF.

aarrggbb
Nombre hexadécimal à huit chiffres. Les deux premiers chiffres spécifient la valeur de A la couleur, les deux suivantes spécifient sa R valeur, les deux suivantes spécifient sa G valeur et les deux derniers spécifient sa B valeur. Par exemple : FF0000FF.

Sca
System.Single

Valeur de la ScA couleur.

Scr
System.Single

Valeur de la ScR couleur.

Scg
System.Single

Valeur de la ScG couleur.

Scb
System.Single

Valeur de la ScB couleur.

profileUri
System.Uri

Profil de couleur international (ICC) ou gestion des couleurs d’image (ICM).

alphaValue
System.Single

Valeur de couleur du canal alpha. La plage de valeurs est de 0,0 à 1,0.

Colorvalue
System.Single

Liste délimitée par des virgules de trois à huit valeurs qui représentent les canaux de couleur du profil de couleur. La plage de valeurs est de 0,0 à 1,0.

Propriétés

A	Obtient ou définit la valeur du canal alpha sRGB de la couleur.
B	Obtient ou définit la valeur du canal bleu sRGB de la couleur.
ColorContext	Obtient le profil de couleur International Color Consortium (ICC) ou Image Color Management (ICM) de la couleur.
G	Obtient ou définit la valeur du canal vert sRGB de la couleur.
R	Obtient ou définit la valeur du canal rouge sRGB de la couleur.
ScA	Obtient ou définit la valeur du canal alpha ScRGB de la couleur.
ScB	Obtient ou définit la valeur du canal bleu ScRVB de la couleur.
ScG	Obtient ou définit la valeur du canal vert ScRGB de la couleur.
ScR	Obtient ou définit la valeur du canal rouge ScRGB de la couleur.

Méthodes

Add(Color, Color)	Ajoute deux structures Color.
AreClose(Color, Color)	Compare l'égalité approximative de deux structures Color.
Clamp()	Définit les canaux ScRGB de la couleur dans une gamme de 0 à 1, s'ils sont à l'extérieur de cette plage.
Equals(Color)	Teste si la structure Color spécifiée est identique à cette couleur.
Equals(Color, Color)	Teste si deux structures Color sont identiques.
Equals(Object)	Vérifie si l'objet spécifié est une structure Color et s'il équivaut à cette couleur.
FromArgb(Byte, Byte, Byte, Byte)	Crée une nouvelle structure Color en utilisant le canal alpha sRGB et les valeurs de canaux de couleurs spécifiés.
FromAValues(Single, Single[], Uri)	Crée une nouvelle structure Color en utilisant le canal alpha, les valeurs de canaux de couleurs et le profil de couleurs spécifiés.
FromRgb(Byte, Byte, Byte)	Crée une nouvelle structure Color en utilisant les valeurs des canaux de couleurs sRGB spécifiées.
FromScRgb(Single, Single, Single, Single)	Crée une nouvelle structure Color en utilisant le canal alpha ScRGB et les valeurs de canaux de couleurs spécifiés.
FromValues(Single[], Uri)	Crée une nouvelle structure Color en utilisant les valeurs de canaux de couleurs et le profil de couleurs spécifiés.
GetHashCode()	Obtient un code de hachage pour cette structure Color.
GetNativeColorValues()	Obtient les valeurs de canaux de couleurs de la couleur.
Multiply(Color, Single)	Multiplie les canaux alpha, rouge, bleu et vert de la structure Color requise par la valeur spécifiée.
Subtract(Color, Color)	Soustrait une structure Color d'une autre structure Color.
ToString()	Crée une représentation sous forme de chaîne de la couleur en utilisant les canaux sRGB.
ToString(IFormatProvider)	Crée une représentation sous forme de chaîne de la couleur en utilisant les canaux sRGB et le fournisseur de format spécifié.

Opérateurs

Addition(Color, Color)	Ajoute deux structures Color.
Equality(Color, Color)	Teste si deux structures Color sont identiques.
Inequality(Color, Color)	Teste si deux structures Color ne sont pas identiques.
Multiply(Color, Single)	Multiplie les canaux alpha, rouge, bleu et vert de la structure Color requise par la valeur spécifiée.
Subtraction(Color, Color)	Soustrait une structure Color d'une autre structure Color.

Implémentations d’interfaces explicites

IFormattable.ToString(String, IFormatProvider)

Met en forme la valeur de l’instance actuelle en utilisant le format spécifié.