信息
您所需的主题如下所示。但此主题未包含在此库中。

颜色 Structure

用 Alpha 通道、红色通道、绿色通道和蓝色通道描述颜色。

语法


var color = {
    a : /* 你的值 */,
    b : /* 你的值 */,
    g : /* 你的值 */,
    r : /* 你的值 */
}


<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

Colors 类预定义的颜色之一。有关列表,请参见 Colors 成员。这些是静态属性。只指定颜色名称,例如 "透明"。不要在字符串中包括静态类限定符:例如,"Colors.Transparent" 不在 XAML 中分析。

rgb

三个字符的十六进制值。第一个字符指定颜色的 R 值,第二个字符指定 G 值,第三个字符指定 B 值。例如,00F

argb

四个字符的十六进制值。第一个字符指定颜色的 A 值,第二个字符指定其 R 值,第三个字符指定 G 值,第四个字符指定其 B 值。例如,F00F

rrggbb

六个字符的十六进制值。前两个字符指定颜色的 R 值,后两个字符指定其 G 值,最后两个字符指定其 B 值。例如,0000FF

aarrggbb

八个字符的十六进制值。前两个字符指定颜色的 A 值,下两个字符指定其 R 值,接下来的两个字符指定其 G 值,最后两个字符指定其 B 值。例如,FF0000FF

scA

颜色的 ScA 值介于 0 和 1 之间。

scR

颜色的 ScR 值介于 0 和 1 之间。

scG

颜色的 ScG 值介于 0 和 1 之间。

scB

颜色的 ScB 值介于 0 和 1 之间。

特性

[Version(0x06020000)]

成员

Color结构 具有这些类型的成员:

字段

Color结构 具有这些字段。

字段数据类型说明
A | a [C++, JavaScript]

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

获取或设置颜色的 sRGB alpha 通道值。

B | b [C++, JavaScript]

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

获取或设置颜色的 sRGB 蓝色通道值。

G | g [C++, JavaScript]

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

获取或设置颜色的 sRGB 绿色通道值。

R | r [C++, JavaScript]

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

获取或设置颜色的 sRGB 红色通道值。

 

方法

The Color 结构 具有这些方法。 对于 C#、Visual Basic 和 C++,它还继承方法于Object 类.

方法说明
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.

 

运算符

Color结构 具有这些运算符。

运算符说明
Equality Compares two Color structures for equality.
Inequality Compares two Color structures for inequality.

 

属性

Color结构 具有这些属性。

属性访问类型说明

A [C#, VB]

读/写Gets or sets the sRGB alpha channel value of the color.

B [C#, VB]

读/写Gets or sets the sRGB blue channel value of the color.

G [C#, VB]

读/写Gets or sets the sRGB green channel value of the color.

R [C#, VB]

读/写Gets or sets the sRGB red channel value of the color.

 

备注

Color 是 Windows 运行时结构,表示具有四个通道的颜色:A (alpha)、R(红色)、G(绿色)和 B(蓝色)。每个值都作为介于值 0-255 的 Byte 类型存储。

Color 值用于以下功能和方案中:

  • 开始屏幕的颜色和一般 UI(如,SecondaryTile.BackgroundColorUISettings.UIElementColor)。这些可用于 JavaScript 中。
  • Windows 8 供墨系统的颜色值。尤其是在下列情况下,InkDrawingAttributes.Color。可以在 JavaScript 中使用。
  • 颜色值,用于 XAML UI 和使用 C++、C# 或 Visual Basic 编写的 Windows 应用商店应用程序,尤其是用于画笔。这些 API 不能用于 JavaScript 中。
  • Windows.UI.Text 命名空间中定义用于表示文本的接口的颜色值。这些 API 不能用于 JavaScript 中。

颜色值和 XAML 定义

Color 最常见的应用是作为使用 C++、C# 或 Visual Basic 及其 XAML UI 定义的 Windows Store 应用程序的一部分定义 UI 元素中的颜色相关属性。

各种预定义 Color 值是以 Colors 类上的静态属性的形式提供的。设置代码中匹配 XAML 中使用的属性字符串形式的Color 值以设置已命名 Color 时,这些属性非常有用。例如,Colors.AliceBlue 属性返回的 Color 的值与 XAML 中用诸如等 <SolidColorBrush Color="AliceBlue" /> 语法设置的 Color 的值相同。还可使用 Colors 值进行相等比较。

在大多数 XAML UI 方案中,不直接将 Color 用作 UIElement 的属性值。相反,Color 用作 BrushSolidColorBrushLinearGradientBrush)的分量值。但是,Brush 类型启用 XAML 的简短表示,可让您使用命名颜色字符串或可以分析为 ARGB 窗体的格式字符串设置类型 Brush 的属性值。例如,可使用诸如 <TextBlock Foreground="Cyan" /> 等语法设置 Brush 类型的值 TextBlock.Foreground。此语法使用 Color 值隐式创建新 SolidColorBrush,该值等于填充该元素的 TextBlock.ForegroundBrush 类型值的 Cyan。有关在 XAML 中使用画笔和颜色的更多信息,请参见快速入门:使用画笔

如果经常在 XAML 中使用同一个画笔,则应将 SolidColorBrush 定义为资源,而不是使用内联隐式创建新值,因为这会更加高效。有关更多信息,请参见优化加载 XAML

还有些直接获取 Color 值的 XAML 属性。这些大多数情况下支持对 Brush 上存在的 Color 值进行动画处理。Windows 运行时支持内插逻辑,以便您可以在 From/To 中从 Color 到另一个进行动画处理,并且在动画运行时动画将使用内插的 Color 值。有关更多信息,请参见情节提要化动画

关于 XAML 语法的说明

如果使用 "#" 标记指定十六进制的颜色值,十六进制值在结构中存储为介于 0 和 255 之间的值,而不是原始十六进制的字符串。如果使用 "sc#" 标记,则值也作为介于 0 和 255 之间的值存储,而不是原来的 0 至 1 的值。

命名颜色的字符串基于相关联的 Colors 常量进行解释,ARGB 将在结构中设置为代表颜色的 0 和 255 之间的值。

XAML 对象元素用法(具有初始化文本)可用于将 Color 声明为 XAML ResourceDictionary 中的资源。 有关更多信息,请参见 ResourceDictionary 和 XAML 资源参考

颜色的投影和成员

如果要使用 Microsoft .NET 语言(C# 或 Microsoft Visual Basic),则 Color 具有静态方法 FromArgb,用作 Color 值生成器。此外,Color 的数据成员是公开为读-写属性。

如果要使用 C++ 编程,无论是 Visual C++ 组件扩展 (C++/CX) 还是 WRL,都只有数据成员字段以 Color 成员的形式存在,且不能使用成员表中列出的实用工具方法或属性。C++ 代码可以将等效 FromArgb 方法用于 ColorHelper 类。

要求

最低支持客户端

Windows 8

最低支持服务器

Windows Server 2012

最低支持电话

Windows Phone 8

命名空间

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

元数据

Windows.winmd

程序集

System.Runtime.WindowsRuntime.dll

另请参见

快速入门:使用画笔
Colors
ColorHelper
SolidColorBrush
ResourceDictionary 和 XAML 资源引用

 

 

显示: