Color, structure

Color Structure

Décrit une couleur en termes de canaux alpha, rouges, verts et bleus.

Syntaxe


var color = {
    a : /* Votre valeur */,
    b : /* Votre valeur */,
    g : /* Votre valeur */,
    r : /* Votre valeur */
}


<Color ...>predefinedColor</Color>
- or -
<Color ...>#rgb</Color>
- or -
<Color ...>#argb</Color>
- or -
<Color ...>#rrggbb</Color>
- or -
<Color ...>#aarrggbb</Color>
- or -
<Color ...>sc#scR,scG,scB</Color>
- or -
<Color ...>sc#scA,scR,scG,scB</Color>


<object property="predefinedColor"/>
- or -
<object property="#rgb"/>
- or -
<object property="#argb"/>
- or -
<object property="#rrggbb"/>
- or -
<object property="#aarrggbb"/>
- or -
<object property="sc#scR,scG,scB"/>
- or -
<object property="sc#scA,scR,scG,scB"/>

XAML Values

predefinedColor

L'une des couleurs prédéfinie par la classe Colors. Consultez les membres de Colors pour obtenir une liste. Ces propriétés sont statiques. Spécifie uniquement le nom de la couleur, par exemple "Transparent". N'incluez pas le qualificateur de classe statique dans la chaîne : par exemple, "Colors.Transparent" n'analyse pas le code XAML.

rgb

Valeur hexadécimale à trois caractères. Le premier caractère spécifie la valeur R de la couleur, le deuxième caractère sa valeur G et le troisième caractère sa valeur B. Par exemple, 00F.

argb

Valeur hexadécimale à quatre caractères. Le premier caractère spécifie la valeur A de la couleur, le deuxième caractère sa valeur R, le troisième caractère sa valeur G, et le quatrième caractère sa valeur B. Par exemple, F00F.

rrggbb

Valeur hexadécimale à six caractères. Les deux premiers caractères spécifient la valeur R de la couleur, les deux suivants sa valeur G et les deux derniers sa valeur B. Par exemple, 0000FF.

aarrggbb

Valeur hexadécimale à huit caractères. Les deux premiers caractères spécifient la valeur A de la couleur, les deux suivants sa valeur R, les deux suivants sa valeur G, et les deux derniers sa valeur B. Par exemple, FF0000FF.

scA

Valeur ScA de la couleur sous la forme d'une valeur comprise entre 0 et 1.

scR

Valeur ScR de la couleur sous la forme d'une valeur comprise entre 0 et 1.

scG

Valeur ScG de la couleur sous la forme d'une valeur comprise entre 0 et 1.

scB

Valeur ScB de la couleur sous la forme d'une valeur comprise entre 0 et 1.

Attributs

[Version(0x06020000)]

Membres

ColorStructure possède ces types de membres :

Champs

ColorStructure possède ces champs.

ChampType de donnéesDescription
A | a [C++, JavaScript]

Number [JavaScript] | System.Byte [.NET] | uint8 [C++]

Obtient ou définit la valeur du canal alpha sRGB de la couleur.

B | b [C++, JavaScript]

Number [JavaScript] | System.Byte [.NET] | uint8 [C++]

Obtient ou définit la valeur du canal bleu sRGB de la couleur.

G | g [C++, JavaScript]

Number [JavaScript] | System.Byte [.NET] | uint8 [C++]

Obtient ou définit la valeur du canal vert sRGB de la couleur.

R | r [C++, JavaScript]

Number [JavaScript] | System.Byte [.NET] | uint8 [C++]

Obtient ou définit la valeur du canal rouge sRGB de la couleur.

 

Méthodes

The Color Structure a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
Equals(Color) [C#, VB]Compares two Color structures for equality.
Equals(Object) [C#, VB]Determines whether the specified object is equal to a Color.
FromArgb [C#, VB]Creates a new Color structure by using the specified sRGB alpha channel and color channel values.
GetHashCode [C#, VB]Gets a hash code for this object.
ToString [C#, VB]Creates a String representation of this Color.
ToString(IFormatProvider) [C#, VB]Creates a String representation of this Color, using a specified formatter.

 

Opérateurs

ColorStructure possède ces opérateurs.

OpérateurDescription
Equality Compares two Color structures for equality.
Inequality Compares two Color structures for inequality.

 

Propriétés

Le ColorStructure a les propriétés suivantes.

PropriétéType d'accèsDescription

A [C#, VB]

Lecture/écritureGets or sets the sRGB alpha channel value of the color.

B [C#, VB]

Lecture/écritureGets or sets the sRGB blue channel value of the color.

G [C#, VB]

Lecture/écritureGets or sets the sRGB green channel value of the color.

R [C#, VB]

Lecture/écritureGets or sets the sRGB red channel value of the color.

 

Remarques

Color est une structure Windows Runtime qui représente une couleur comportant quatre canaux : A (alpha), R (rouge), G (vert), B (bleu). Chacune des valeurs est stockée en tant que type Byte avec la valeur 0-255.

Color les valeurs sont utilisées dans ces fonctionnalités et scénarios :

  • Couleurs pour les écrans de démarrage et l'interface utilisateur générale (par exemple, SecondaryTile.BackgroundColor et UISettings.UIElementColor). Ceux-ci peuvent être utilisés en JavaScript.
  • Valeurs de couleur pour le système d'encre Windows 8 . Plus précisément, InkDrawingAttributes.Color. Dans ce cas, JavaScript peut être utilisé.
  • Valeurs de couleur pour l'interface utilisateur XAML et les applications Windows Store en C++, C# ou Visual Basic, en particulier pour les pinceaux. Ces API ne peuvent pas être utilisées en JavaScript.
  • Définition des valeurs de couleur qui sont utilisées pour les interfaces qui représentent le texte, dans l'espace de noms Windows.UI.Text. Ces API ne peuvent pas être utilisées en JavaScript.

Valeurs de couleur et définitions XAML

L'application la plus fréquente de Color est de définir les propriétés relatives à la couleur d'un élément d'interface dans le cadre d'une application Windows Store à l'aide de C++, C# ou Visual Basic et sa définition de l'interface utilisateur XAML.

Différentes valeurs Color prédéfinies sont disponibles en tant que propriétés statiques de la classe Colors. Ces propriétés sont utiles pour définir les valeurs Color dans le code qui correspondent à la forme de chaîne d'attribut utilisée en XAML pour définir une Color nommée. Par exemple, la propriété Colors.AliceBlue retourne une Color qui est égale en valeur à la Color définie en XAML avec une syntaxe comme <SolidColorBrush Color="AliceBlue" />. Vous pouvez également utiliser les valeurs Colors pour les comparaisons d'égalité.

Dans la plupart des scénarios d'interface utilisateur XAML, une Color n'est pas utilisée directement comme valeur de propriété d'un UIElement. À la place, Color est utilisé comme valeur de composant de Brush ( SolidColorBrush ou LinearGradientBrush). Toutefois, le type Brush active une forme abrégée du code XAML qui vous permet de définir une valeur d'attribut de type Brush à l'aide d'une chaîne de couleur nommée ou d'une chaîne de format qui peut être analysée au format ARGB. Par exemple, définissez TextBlock.Foreground de la valeur de type Brush à l'aide d'une syntaxe telle que <TextBlock Foreground="Cyan" />. Cette syntaxe crée implicitement un SolidColorBrush avec une valeur Color égale à Cyan qui remplit la valeur de type Brush de TextBlock.Foreground pour cet élément. Pour plus d'informations sur l'utilisation des pinceaux et des couleurs en XAML, consultez la rubrique Démarrage rapide : utilisation des pinceaux.

Si vous utilisez le même pinceau de couleur souvent dans votre XAML, vous devez définir un SolidColorBrush comme ressource au lieu d'utiliser la création implicite inline de nouvelles valeurs, car c'est plus efficace. Pour plus d'informations, consultez Optimiser le chargement XAML.

Il existe également quelques propriétés XAML qui prennent une valeur Color directe. Elles prennent principalement en charge l'animation d'une valeur Color qui existe sur un Brush. Windows Runtime prend en charge une logique d'interpolation afin que vous puissiez animer d'une Color à une autre dans une animation From/To et l'animation utilisera les valeurs Color interpolées à mesure que l'animation s'exécute. Pour plus d'informations, consultez Animations avec plan conceptuel.

Remarques sur la syntaxe XAML

Si vous utilisez le jeton "#" pour spécifier des valeurs de couleur au format hexadécimal, les valeurs hexadécimales sont stockées dans la structure sous forme de valeurs comprises entre 0 et 255, et non comme chaînes hexadécimales d'origine. Si vous utilisez le jeton "sc#", les valeurs sont également stockées sous forme de valeurs comprises entre 0 et 255, et non comme la valeur d'origine 0 et 1.

Les chaînes correspondant aux couleurs nommées sont interprétées en fonction des constantes Colors associées, et les valeurs de A, R, G et B sont définies dans la structure comme des valeurs comprises entre 0 et 255 qui représentent cette couleur.

L'utilisation de l'élément objet XAML (avec texte d'initialisation) est utile pour déclarer une Color en tant que ressource dans un ResourceDictionary XAML. Pour plus d'informations, consultez ResourceDictionary et références de ressources XAML.

Projection et membres de Color

Si vous utilisez un langage Microsoft .NET (C# ou Microsoft Visual Basic), Color a une méthode statique FromArgb qui fonctionne comme un générateur de valeurs Color. En outre, les membres de données de Color sont exposés comme des propriétés en lecture/écriture.

Si vous programmez en C++ avec les extensions de composants Visual C++ (C++/CX) ou WRL, seuls les champs des données membres existent en tant que membres de Color, et vous ne pouvez pas utiliser les méthodes ou propriétés utilitaires répertoriées dans le tableau des membres. Le code C++ peut utiliser une méthode FromArgb équivalente dans la classe ColorHelper.

Conditions requises

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

Téléphone minimal pris en charge

Windows Phone 8

Espace de noms

Windows.UI
Windows::UI [C++]

Métadonnées

Windows.winmd

Assembly

System.Runtime.WindowsRuntime.dll

Voir aussi

Démarrage rapide : utilisation des pinceaux
Colors
ColorHelper
SolidColorBrush
ResourceDictionary et références de ressources XAML

 

 

Afficher:
© 2016 Microsoft