Color Structure

Describe un color en términos de canales alfa, rojo, verde y azul.

Sintaxis


var color = {
    a : /* Su valor */,
    b : /* Su valor */,
    g : /* Su valor */,
    r : /* Su valor */
}


<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

Uno de los colores predefinidos por la clase Colors. Para obtener una lista de los miembros vea Colors. Son propiedades estáticas. Especifique solo el nombre de color, por ejemplo "Transparent". No incluya el calificador de clases estático en la cadena: por ejemplo "Colors.Transparent" no se analiza en XAML.

rgb

Valor hexadecimal de tres caracteres. El primer carácter especifica el valor R del color, el segundo carácter especifica el valor G y el tercer carácter especifica el valor B. Por ejemplo, 00F.

argb

Valor hexadecimal de cuatro caracteres. El primer carácter especifica el valor A del color, el segundo carácter especifica su valor R, el tercer carácter especifica el valor G y el cuarto carácter especifica su valor B. Por ejemplo, F00F.

rrggbb

Valor hexadecimal de seis caracteres. Los dos primeros caracteres especifican el valor R del color, los dos siguientes especifican su valor G y los dos últimos especifican el valor B. Por ejemplo, 0000FF.

aarrggbb

Valor hexadecimal de ocho caracteres. Los dos primeros caracteres especifican el valor A del color, los dos siguientes especifican su valor R, los dos siguientes especifican su valor G y los últimos dos especifican su valor B. Por ejemplo, FF0000FF.

scA

Valor ScA de color como un valor comprendido entre 0 y 1.

scR

Valor ScR de color como un valor entre 0 y 1.

scG

El valor ScG de color como un valor entre 0 y 1.

scB

El valor ScB de color como un valor entre 0 y 1.

Atributos

[Version(0x06020000)]

Members

A continuación se indican los tipos de miembros de Color (Estructura):

Campos

A continuación se indican los campos de Color (Estructura).

CampoTipo de datosDescripción
A | a [C++, JavaScript]

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

Obtiene o establece el valor de canal alfa sRGB del color.

B | b [C++, JavaScript]

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

Obtiene o establece el valor de canal azul sRGB del color.

G | g [C++, JavaScript]

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

Obtiene o establece el valor de canal verde sRGB del color.

R | r [C++, JavaScript]

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

Obtiene o establece el valor de canal rojo sRGB del color.

 

Métodos

The Color Estructura tiene estos métodos. Con C#, Visual Basic y C++, también hereda métodos de Object Clase.

MétodoDescripción
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.

 

Operadores

A continuación se indican los operadores de Color (Estructura).

OperadorDescripción
Equality Compares two Color structures for equality.
Inequality Compares two Color structures for inequality.

 

Propiedades

ColorEstructura tiene estas propiedades.

PropiedadTipo de accesoDescripción

A [C#, VB]

Lectura/escrituraGets or sets the sRGB alpha channel value of the color.

B [C#, VB]

Lectura/escrituraGets or sets the sRGB blue channel value of the color.

G [C#, VB]

Lectura/escrituraGets or sets the sRGB green channel value of the color.

R [C#, VB]

Lectura/escrituraGets or sets the sRGB red channel value of the color.

 

Comentarios

Color es una estructura de Windows en tiempo de ejecución que representa un color que tiene cuatro canales: A (alfa), R (rojo), G (verde), B (azul). Cada uno de los valores se almacena como un tipo Byte con un valor comprendido entre 0 y 255.

Colorlos valores se utilizan en estas características y escenarios:

  • Colores de las pantallas de inicio y la interfaz de usuario general (por ejemplo, SecondaryTile.BackgroundColor y UISettings.UIElementColor). Estos se puede utilizar en JavaScript.
  • Valores de color para el sistema de tinta de Windows 8. En concreto, InkDrawingAttributes.Color. Esto se puede utilizar en JavaScript.
  • Valores de color para la interfaz de usuario de XAML y las aplicaciones de la Tienda Windows con C++, C# o Visual Basic, especialmente para pinceles. Estas API no se pueden utilizar en JavaScript.
  • Definir valores de color que se usan para las interfaces que representan texto, en el espacio de nombres Windows.UI.Text. Estas API no se pueden utilizar en JavaScript.

Valores de color y definiciones de XAML

La aplicación más frecuente de Color es definir propiedades relacionadas con el color en un elemento de la interfaz de usuario como parte de una aplicación de la Tienda Windows con C++, C# o Visual Basic y su definición de la interfaz de usuario de XAML.

Hay varios valores Color predefinidos disponibles como propiedades estáticas de la clase Colors. Estas propiedades son útiles para establecer valores Color en código que coinciden con el formato de la cadena de atributo utilizado en XAML para establecer un Color con nombre. Por ejemplo, la propiedad Colors.AliceBlue devuelve un Color que es igual que el valor de <SolidColorBrush Color="AliceBlue" /> establecido en XAML con una sintaxis como Color. También puede utilizar los valores de Colors para las comparaciones de igualdad.

En la mayoría de los escenarios de la interfaz de usuario de XAML, Color no se utiliza directamente como valor de propiedad de un UIElement. En su lugar, Color se utiliza como valor componente de un Brush (SolidColorBrush o LinearGradientBrush). Sin embargo, el tipo Brush habilita una forma abreviada de XAML que permite establecer un valor de atributo de tipo Brush mediante una cadena de color con nombre, o una cadena de formato que se pueda analizar en un formato ARGB. Por ejemplo, puede establecer el valor TextBlock.Foreground de tipo Brush utilizando una sintaxis como <TextBlock Foreground="Cyan" />. Esta sintaxis crea implícitamente un nuevo SolidColorBrush con un valor Color igual que Cyan que rellena el valor de tipo Brush de TextBlock.Foreground para ese elemento. Para obtener más información sobre cómo utilizar los pinceles y colores en XAML, vea Inicio rápido: usar pinceles.

Si utiliza el mismo pincel de color a menudo en el XAML, debe definir un SolidColorBrush como recurso en lugar de utilizar la creación implícita alineada de nuevos valores, porque eso es más eficiente. Para obtener más información, vea Optimizar carga de XAML.

También hay algunas propiedades de XAML que toman un valor directo de Color. Admiten principalmente animar un valor Color que existe en un Brush. Windows en tiempo de ejecución admite una lógica de interpolación para poder animar de un Color a otro en una animación From/To y la animación utilizará valores de Color interpolados a medida que se ejecute la animación. Para obtener más información vea Animaciones de guion gráfico.

Notas sobre la sintaxis XAML

Si utiliza el token "#" para especificar valores de color en formato hexadecimal, los valores hexadecimales se almacenan en la estructura como valores entre 0 y 255, no como las cadenas hexadecimales originales. Si utiliza el token "sc#", los valores también se almacenan como valores entre 0 y 255, no como el valor original de 0 a 1.

Las cadenas de colores con nombre se interpretan según las constantes Colors asociadas, y los valores de A, R, G y B se establecen en la estructura como valores entre 0 y 255 representativos de ese color.

El uso de elementos de objeto XAML (con texto de inicialización) es útil para declarar Color como un recurso en un ResourceDictionary de XAML. Para obtener más información, vea Referencias de ResourceDictionary y recurso XAML.

Proyección y miembros de Color

Si está utilizando un lenguaje de Microsoft .NET (C# o Microsoft Visual Basic), entonces Color tiene un método FromArgb estático que actúa como un generador de valores Color. También, los miembros de datos de Color se exponen como propiedades de lectura y escritura.

Si está programando con C++, Extensiones de componentes de Visual C++ (C++/CX) o WRL, solo los campos de miembro de datos existen como miembros de Color, y no puede utilizar métodos o propiedades de utilidad enumerados en la tabla de miembros. El código de C++ puede usar un método FromArgb equivalente en la clase ColorHelper.

Requisitos

Cliente mínimo admitido

Windows 8

Servidor mínimo admitido

Windows Server 2012

Teléfono mínimo admitido

Windows Phone 8

Espacio de nombres

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

Metadatos

Windows.winmd

Ensamblado

System.Runtime.WindowsRuntime.dll

Vea también

Inicio rápido: usar pinceles
Colors
ColorHelper
SolidColorBrush
Referencias de ResourceDictionary y recurso XAML

 

 

Mostrar:
© 2015 Microsoft