Color Struktur

Definition

Beschreibt eine Farbe anhand von Alpha-, Rot-, Grün- und Blau-Kanälen.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
Vererbung
Attribute
Implementiert

Beispiele

In diesem Beispiel wird gezeigt, wie Sie die Werte sRGB, ScRGB und Color Profile verwenden, um die Farbe blau zu erstellen.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>

Hinweise

Verwendung von XAML-AttributenXAML 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-WerteXAML Values

predefinedColorpredefinedColor
Eine der Farben, die von der Colors -Klasse vordefiniert werden.One of the colors predefined by the Colors class.

rgbrgb
Eine dreistellige hexadezimal Zahl.A three-digit hexadecimal number. Die erste Ziffer gibt den Wert der R Farbe, die zweite Ziffer den G Wert und die dritte Ziffer den B Wert an.The first digit specifies the color's R value, the second digit specifies the G value, and the third digit specifies the B value. Beispielsweise 00F.For example, 00F.

argbargb
Eine vierstellige hexadezimal Zahl.A four-digit hexadecimal number. Die erste Ziffer gibt den Wert der A Farbe an, die zweite Ziffer gibt R ihren Wert an, die nächste Ziffer G gibt den Wert an, und die letzte B Ziffer gibt ihren Wert an.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. Beispielsweise F00F.For example, F00F.

rrggbbrrggbb
Eine sechsstellige hexadezimal Zahl.A six-digit hexadecimal number. Die ersten beiden Ziffern geben den Wert der R Farbe an, die nächsten beiden Werte G geben ihren Wert an, und die letzten B beiden Ziffern geben ihren Wert an.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. Beispielsweise 0000FF.For example, 0000FF.

aarrggbbaarrggbb
Eine achtstellige hexadezimal Zahl.An eight-digit hexadecimal number. Die ersten beiden Ziffern geben den Wert der A Farbe an, die nächsten R beiden Werte geben ihren Wert an, G die nächsten zwei Ziffern geben ihren Wert an, und B die letzten beiden geben ihren Wert an.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. Beispielsweise FF0000FF.For example, FF0000FF.

scAscA
System.Single

Der ScA Wert der Farbe.The color's ScA value.

scRscR
System.Single

Der ScR Wert der Farbe.The color's ScR value.

scGscG
System.Single

Der ScG Wert der Farbe.The color's ScG value.

scBscB
System.Single

Der ScB Wert der Farbe.The color's ScB value.

profileUriprofileUri
System.Uri

Das International Color Consortium (ICC)International Color Consortium (ICC) - Farbverwaltung (Image Color Management; ICM)Image Color Management (ICM) oder-Farbprofil.The International Color Consortium (ICC)International Color Consortium (ICC) or Farbverwaltung (Image Color Management; ICM)Image Color Management (ICM) color profile.

alphaValuealphaValue
System.Single

Der Farbwert des Alphakanals.The alpha channel color value. Der Wertebereich liegt zwischen 0,0 und 1,0.The value range is 0.0 to 1.0.

colorValuecolorValue
System.Single

Eine durch Trennzeichen getrennte Liste von drei bis acht Werten, die die Farbkanäle des Farbprofils darstellen.A comma-delimited list of three to eight values that represent the color channels of the color profile. Der Wertebereich liegt zwischen 0,0 und 1,0.The value range is 0.0 to 1.0.

Eigenschaften

A

Ruft den sRGB-Alphakanalwert der Farbe ab oder legt diesen fest.Gets or sets the sRGB alpha channel value of the color.

B

Ruft den sRGB-Blaukanalwert der Farbe ab oder legt diesen fest.Gets or sets the sRGB blue channel value of the color.

ColorContext

Ruft das International Color Consortium (ICC)International Color Consortium (ICC)-Farbprofil oder das Farbverwaltung (Image Color Management; ICM)Image Color Management (ICM)-Farbprofil der Farbe ab.Gets the International Color Consortium (ICC)International Color Consortium (ICC) or Farbverwaltung (Image Color Management; ICM)Image Color Management (ICM) color profile of the color.

G

Ruft den sRGB-Grünkanalwert der Farbe ab oder legt diesen fest.Gets or sets the sRGB green channel value of the color.

R

Ruft den sRGB-Rotkanalwert der Farbe ab oder legt diesen fest.Gets or sets the sRGB red channel value of the color.

ScA

Ruft den ScRGB-Alphakanalwert der Farbe ab oder legt diesen fest.Gets or sets the ScRGB alpha channel value of the color.

ScB

Ruft den ScRGB-Blaukanalwert der Farbe ab oder legt diesen fest.Gets or sets the ScRGB blue channel value of the color.

ScG

Ruft den ScRGB-Grünkanalwert der Farbe ab oder legt diesen fest.Gets or sets the ScRGB green channel value of the color.

ScR

Ruft den ScRGB-Rotkanalwert der Farbe ab oder legt diesen fest.Gets or sets the ScRGB red channel value of the color.

Methoden

Add(Color, Color)

Addiert zwei Color-Strukturen.Adds two Color structures.

AreClose(Color, Color)

Vergleicht zwei Color-Strukturen auf unscharfe Gleichheit.Compares two Color structures for fuzzy equality.

Clamp()

Legt die ScRGB-Kanäle der Farbe auf einen Wert von 0 bis 1 in der Farbskala fest, falls die Werte außerhalb dieses Bereichs liegen.Sets the ScRGB channels of the color to within the gamut of 0 to 1, if they are outside that range.

Equals(Color)

Überprüft, ob die angegebene Color-Struktur mit dieser Farbe identisch ist.Tests whether the specified Color structure is identical to this color.

Equals(Color, Color)

Überprüft, ob zwei Color-Strukturen identisch sind.Tests whether two Color structures are identical.

Equals(Object)

Überprüft, ob das angegebene Objekt eine Color-Struktur ist und dieser Farbe entspricht.Tests whether the specified object is a Color structure and is equivalent to this color.

FromArgb(Byte, Byte, Byte, Byte)

Erstellt mithilfe der angegebenen sRGB-Alphakanal- und -Farbkanalwerte eine neue Color-Struktur.Creates a new Color structure by using the specified sRGB alpha channel and color channel values.

FromAValues(Single, Single[], Uri)

Erstellt mithilfe der angegebenen Alphakanal- und Farbkanalwerte sowie des angegebenen Farbprofils eine neue Color-Struktur.Creates a new Color structure by using the specified alpha channel, color channel values, and color profile.

FromRgb(Byte, Byte, Byte)

Erstellt mithilfe der angegebenen sRGB-Farbkanalwerte eine neue Color-Struktur.Creates a new Color structure by using the specified sRGB color channel values.

FromScRgb(Single, Single, Single, Single)

Erstellt mithilfe der angegebenen ScRGB-Alphakanal- und -Farbkanalwerte eine neue Color-Struktur.Creates a new Color structure by using the specified ScRGB alpha channel and color channel values.

FromValues(Single[], Uri)

Erstellt mithilfe der angegebenen Farbkanalwerte und des angegebenen Farbprofils eine neue Color-Struktur.Creates a new Color structure by using the specified color channel values and color profile.

GetHashCode()

Ruft einen Hashcode für die Color-Struktur ab.Gets a hash code for this Color structure.

GetNativeColorValues()

Ruft die Farbkanalwerte der Farbe ab.Gets the color channel values of the color.

Multiply(Color, Single)

Multipliziert den Alpha-, Rot-, Blau- und Grünkanal der angegebenen Color-Struktur mit dem angegebenen Wert.Multiplies the alpha, red, blue, and green channels of the specified Color structure by the specified value.

Subtract(Color, Color)

Subtrahiert eine Color-Struktur von einer Color-Struktur.Subtracts a Color structure from a Color structure.

ToString()

Erstellt mithilfe der sRGB-Kanäle eine Zeichenfolgendarstellung der Farbe.Creates a string representation of the color using the sRGB channels.

ToString(IFormatProvider)

Erstellt mithilfe der sRGB-Kanäle und des angegebenen Formatanbieters eine Zeichenfolgendarstellung der Farbe.Creates a string representation of the color by using the sRGB channels and the specified format provider.

Operatoren

Addition(Color, Color)

Addiert zwei Color-Strukturen.Adds two Color structures.

Equality(Color, Color)

Überprüft, ob zwei Color-Strukturen identisch sind.Tests whether two Color structures are identical.

Inequality(Color, Color)

Überprüft, ob zwei Color-Strukturen nicht identisch sind.Tests whether two Color structures are not identical.

Multiply(Color, Single)

Multipliziert den Alpha-, Rot-, Blau- und Grünkanal der angegebenen Color-Struktur mit dem angegebenen Wert.Multiplies the alpha, red, blue, and green channels of the specified Color structure by the specified value.

Subtraction(Color, Color)

Subtrahiert eine Color-Struktur von einer Color-Struktur.Subtracts a Color structure from a Color structure.

Explizite Schnittstellenimplementierungen

IFormattable.ToString(String, IFormatProvider)

Formatiert den Wert der aktuellen Instanz unter Verwendung des angegebenen Formats.Formats the value of the current instance using the specified format.

Gilt für: