Color Struct

Reference

Definition

Namespace:: System.Windows.Media

Assembly:: PresentationCore.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Describes a color in terms of alpha, red, green, and blue channels.

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

Inheritance: Object

ValueType
Color

Attributes: TypeConverterAttribute LocalizabilityAttribute

Implements: IEquatable<Color> IFormattable

Examples

This example shows how to use sRGB, ScRGB, and color profile values to create the color blue.

<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>

Remarks

XAML Attribute Usage

<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"/>

XAML Values

predefinedColor
One of the colors predefined by the Colors class.

rgb
A three-digit hexadecimal number. The first digit specifies the color's R value, the second digit specifies the G value, and the third digit specifies the B value. For example, 00F.

argb
A four-digit hexadecimal number. The first digit specifies the color's A value, the second digit specifies its R value, the next digit specifies the G value, and the final digit specifies its B value. For example, F00F.

rrggbb
A six-digit hexadecimal number. The first two digits specify the color's R value, the next two specify its G value, and the final two specify its B value. For example, 0000FF.

aarrggbb
An eight-digit hexadecimal number. The first two digits specify the color's A value, the next two specify its R value, the next two specify its G value, and the final two specify its B value. For example, FF0000FF.

scA
System.Single

The color's ScA value.

scR
System.Single

The color's ScR value.

scG
System.Single

The color's ScG value.

scB
System.Single

The color's ScB value.

profileUri
System.Uri

The International Color Consortium (ICC) or Image Color Management (ICM) color profile.

alphaValue
System.Single

The alpha channel color value. The value range is 0.0 to 1.0.

colorValue
System.Single

A comma-delimited list of three to eight values that represent the color channels of the color profile. The value range is 0.0 to 1.0.

Properties

A	Gets or sets the `sRGB` alpha channel value of the color.
B	Gets or sets the `sRGB` blue channel value of the color.
ColorContext	Gets the International Color Consortium (ICC) or Image Color Management (ICM) color profile of the color.
G	Gets or sets the `sRGB` green channel value of the color.
R	Gets or sets the `sRGB` red channel value of the color.
ScA	Gets or sets the `ScRGB` alpha channel value of the color.
ScB	Gets or sets the ScRGB blue channel value of the color.
ScG	Gets or sets the `ScRGB` green channel value of the color.
ScR	Gets or sets the `ScRGB` red channel value of the color.

Methods

Add(Color, Color)	Adds two Color structures.
AreClose(Color, Color)	Compares two Color structures for fuzzy equality.
Clamp()	Sets the `ScRGB` channels of the color to within the gamut of 0 to 1, if they are outside that range.
Equals(Color)	Tests whether the specified Color structure is identical to this color.
Equals(Color, Color)	Tests whether two Color structures are identical.
Equals(Object)	Tests whether the specified object is a Color structure and is equivalent to this color.
FromArgb(Byte, Byte, Byte, Byte)	Creates a new Color structure by using the specified `sRGB` alpha channel and color channel values.
FromAValues(Single, Single[], Uri)	Creates a new Color structure by using the specified alpha channel, color channel values, and color profile.
FromRgb(Byte, Byte, Byte)	Creates a new Color structure by using the specified `sRGB` color channel values.
FromScRgb(Single, Single, Single, Single)	Creates a new Color structure by using the specified `ScRGB` alpha channel and color channel values.
FromValues(Single[], Uri)	Creates a new Color structure by using the specified color channel values and color profile.
GetHashCode()	Gets a hash code for this Color structure.
GetNativeColorValues()	Gets the color channel values of the color.
Multiply(Color, Single)	Multiplies the alpha, red, blue, and green channels of the specified Color structure by the specified value.
Subtract(Color, Color)	Subtracts a Color structure from a Color structure.
ToString()	Creates a string representation of the color using the `sRGB` channels.
ToString(IFormatProvider)	Creates a string representation of the color by using the `sRGB` channels and the specified format provider.

Operators

Addition(Color, Color)	Adds two Color structures.
Equality(Color, Color)	Tests whether two Color structures are identical.
Inequality(Color, Color)	Tests whether two Color structures are not identical.
Multiply(Color, Single)	Multiplies the alpha, red, blue, and green channels of the specified Color structure by the specified value.
Subtraction(Color, Color)	Subtracts a Color structure from a Color structure.

Explicit Interface Implementations

IFormattable.ToString(String, IFormatProvider)

Formats the value of the current instance using the specified format.

Applies to

Share via