Color 構造体

定義

アルファ、赤、緑、および青のチャネルで色を記述します。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
type Color = struct
    interface IFormattable
Public Structure Color
Implements IEquatable(Of Color), IFormattable
継承
属性
実装

この例では、sRGB、ScRGB、およびカラープロファイル値を使用して青色を作成する方法を示します。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>

注釈

XAML 属性の使用方法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 値XAML Values

predefinedColorpredefinedColor
Colorsクラスによって定義された色の1つ。One of the colors predefined by the Colors class.

rgbrgb
3桁の16進数。A three-digit hexadecimal number. 最初の数字は、色のR値を指定し、2番G目の数字は値を指定しB 、3番目の数字は値を指定します。The first digit specifies the color's R value, the second digit specifies the G value, and the third digit specifies the B value. たとえば、00F のようにします。For example, 00F.

argbargb
4桁の16進数。A four-digit hexadecimal number. 最初の数字は、色のA値を指定し、2番R目の数字はその値をG指定し、次の桁は値Bを指定し、最後の数字はその値を指定します。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. たとえば、F00F のようにします。For example, F00F.

rrggbbrrggbb
6桁の16進数。A six-digit hexadecimal number. 最初の2桁は色のR値を指定し、次の2桁はそのG値を指定し、 B最後の2桁はその値を指定します。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. たとえば、0000FF のようにします。For example, 0000FF.

aarrggbbaarrggbb
8桁の16進数。An eight-digit hexadecimal number. 最初の 2 A桁は色の値を指定し、次Rの2つの数字はその値をG指定し、次の2つのB数字は値を指定し、最後の2桁はその値を指定します。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. たとえば、FF0000FF のようにします。For example, FF0000FF.

scAscA
System.Single

色のScA値。The color's ScA value.

scRscR
System.Single

色のScR値。The color's ScR value.

scGscG
System.Single

色のScG値。The color's ScG value.

scBscB
System.Single

色のScB値。The color's ScB value.

profileUriprofileUri
System.Uri

またInternational Color Consortium (ICC)International Color Consortium (ICC)イメージ カラーの管理 (ICM)Image Color Management (ICM)のカラープロファイル。The International Color Consortium (ICC)International Color Consortium (ICC) or イメージ カラーの管理 (ICM)Image Color Management (ICM) color profile.

alphaValuealphaValue
System.Single

アルファチャネルカラー値。The alpha channel color value. 値の範囲は 0.0 ~ 1.0 です。The value range is 0.0 to 1.0.

colorValuecolorValue
System.Single

カラープロファイルのカラーチャネルを表す 3 ~ 8 個の値のコンマ区切りのリスト。A comma-delimited list of three to eight values that represent the color channels of the color profile. 値の範囲は 0.0 ~ 1.0 です。The value range is 0.0 to 1.0.

プロパティ

A

色の sRGB アルファ チャネルの値を取得または設定します。Gets or sets the sRGB alpha channel value of the color.

B

色の sRGB 青チャネルの値を取得または設定します。Gets or sets the sRGB blue channel value of the color.

ColorContext

色の International Color Consortium (ICC)International Color Consortium (ICC) カラー プロファイルまたは イメージ カラーの管理 (ICM)Image Color Management (ICM) カラー プロファイルを取得します。Gets the International Color Consortium (ICC)International Color Consortium (ICC) or イメージ カラーの管理 (ICM)Image Color Management (ICM) color profile of the color.

G

色の sRGB 緑チャネルの値を取得または設定します。Gets or sets the sRGB green channel value of the color.

R

色の sRGB 赤チャネルの値を取得または設定します。Gets or sets the sRGB red channel value of the color.

ScA

色の ScRGB アルファ チャネルの値を取得または設定します。Gets or sets the ScRGB alpha channel value of the color.

ScB

色の ScRGB 青チャネルの値を取得または設定します。Gets or sets the ScRGB blue channel value of the color.

ScG

色の ScRGB 緑チャネルの値を取得または設定します。Gets or sets the ScRGB green channel value of the color.

ScR

色の ScRGB 赤チャネルの値を取得または設定します。Gets or sets the ScRGB red channel value of the color.

メソッド

Add(Color, Color)

2 つの Color 構造体を加算します。Adds two Color structures.

AreClose(Color, Color)

2 つの Color 構造体を比較し、ほぼ等しいかどうかを確認します。Compares two Color structures for fuzzy equality.

Clamp()

色の ScRGB チャネルが 0 から 1 までの色域に含まれていない場合、それらのチャネルをこの色域内に設定します。Sets the ScRGB channels of the color to within the gamut of 0 to 1, if they are outside that range.

Equals(Color)

指定した Color 構造体が、この色と等しいかどうかをテストします。Tests whether the specified Color structure is identical to this color.

Equals(Color, Color)

2 つの Color 構造体が同じかどうかをテストします。Tests whether two Color structures are identical.

Equals(Object)

指定されたオブジェクトが Color 構造体かどうか、またこの色と等価かどうかをテストします。Tests whether the specified object is a Color structure and is equivalent to this color.

FromArgb(Byte, Byte, Byte, Byte)

指定した sRGB アルファ チャネル値およびカラー チャネル値を使用して新しい Color 構造体を作成します。Creates a new Color structure by using the specified sRGB alpha channel and color channel values.

FromAValues(Single, Single[], Uri)

指定したアルファ コンポーネント チャネル、カラー チャネル値、およびカラー プロファイルを使用して新しい Color 構造体を作成します。Creates a new Color structure by using the specified alpha channel, color channel values, and color profile.

FromRgb(Byte, Byte, Byte)

指定した sRGB カラー チャネル値を使用して新しい Color 構造体を作成します。Creates a new Color structure by using the specified sRGB color channel values.

FromScRgb(Single, Single, Single, Single)

指定した ScRGB アルファ チャネル値およびカラー チャネル値を使用して新しい Color 構造体を作成します。Creates a new Color structure by using the specified ScRGB alpha channel and color channel values.

FromValues(Single[], Uri)

指定したカラー チャネル値およびカラー プロファイルを使用して新しい Color 構造体を作成します。Creates a new Color structure by using the specified color channel values and color profile.

GetHashCode()

この Color 構造体のハッシュ コードを取得します。Gets a hash code for this Color structure.

GetNativeColorValues()

色のカラー チャネル値を取得します。Gets the color channel values of the color.

Multiply(Color, Single)

指定した Color 構造体のアルファ、赤、青、緑の各チャネルを、指定した値で乗算します。Multiplies the alpha, red, blue, and green channels of the specified Color structure by the specified value.

Subtract(Color, Color)

Color 構造体を Color 構造体から減算します。Subtracts a Color structure from a Color structure.

ToString()

sRGB チャネルを使用して、色の文字列表現を作成します。Creates a string representation of the color using the sRGB channels.

ToString(IFormatProvider)

sRGB チャネルおよび指定した書式プロバイダーを使用して、色の文字列表現を作成します。Creates a string representation of the color by using the sRGB channels and the specified format provider.

演算子

Addition(Color, Color)

2 つの Color 構造体を加算します。Adds two Color structures.

Equality(Color, Color)

2 つの Color 構造体が同じかどうかをテストします。Tests whether two Color structures are identical.

Inequality(Color, Color)

2 つの Color 構造体が異なるかどうかをテストします。Tests whether two Color structures are not identical.

Multiply(Color, Single)

指定した Color 構造体のアルファ、赤、青、緑の各チャネルを、指定した値で乗算します。Multiplies the alpha, red, blue, and green channels of the specified Color structure by the specified value.

Subtraction(Color, Color)

Color 構造体を Color 構造体から減算します。Subtracts a Color structure from a Color structure.

明示的なインターフェイスの実装

IFormattable.ToString(String, IFormatProvider)

指定した書式を使用して、現在のインスタンスの値に書式を付けます。Formats the value of the current instance using the specified format.

適用対象