Color Struktur

Definition

Beschreibt eine Farbe anhand von Alpha-, Rot-, Grün- und Blau-Kanälen.

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
Vererbung
Attribute
Implementiert

Beispiele

In diesem Beispiel wird gezeigt, wie Sie die Werte sRGB, ScRGB und Farbprofil verwenden, um die Farbe Blau zu erstellen.

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

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

vordefinierteColor
Eine der von der Colors -Klasse vordefinierten Farben.

Rgb
Eine dreistellige Hexadezimalzahl. Die erste Ziffer gibt den Wert der Farbe R an, die zweite Ziffer den G Wert, und die dritte Ziffer gibt den B Wert an. Beispiel: 00F.

Argb
Eine vierstellige Hexadezimalzahl. Die erste Ziffer gibt den Wert der Farbe A an, die zweite Ziffer ihren R Wert, die nächste Ziffer den G Wert, und die letzte Ziffer gibt ihren B Wert an. Beispiel: F00F.

rrggbb
Eine sechsstellige Hexadezimalzahl. Die ersten beiden Ziffern geben den Wert der Farbe R an, die beiden nächsten geben ihren G Wert an, und die letzten beiden geben ihren B Wert an. Beispiel: 0000FF.

aarrggbb
Eine achtstellige hexadezimale Zahl. Die ersten beiden Ziffern geben den Wert der Farbe A an, die beiden nächsten geben ihren R Wert an, die nächsten beiden geben ihren G Wert an, und die letzten beiden geben ihren B Wert an. Beispiel: FF0000FF.

Sca
System.Single

Der Wert der ScA Farbe.

Scr
System.Single

Der Wert der ScR Farbe.

Scg
System.Single

Der Wert der ScG Farbe.

Scb
System.Single

Der Wert der ScB Farbe.

profileUri
System.Uri

Das Farbprofil des International Color Consortium (ICC) oder des Image Color Management (ICM).

alphaValue
System.Single

Der Alphakanalfarbwert. Der Wertbereich ist 0,0 bis 1,0.

Colorvalue
System.Single

Eine durch Trennzeichen getrennte Liste mit drei bis acht Werten, die die Farbkanäle des Farbprofils darstellen. Der Wertbereich ist 0,0 bis 1,0.

Eigenschaften

A

Ruft den sRGB-Alphakanalwert der Farbe ab oder legt diesen fest.

B

Ruft den sRGB-Blaukanalwert der Farbe ab oder legt diesen fest.

ColorContext

Ruft das Farbprofil des International Color Consortium (ICC) oder des Image Color Management (ICM) der Farbe ab.

G

Ruft den sRGB-Grünkanalwert der Farbe ab oder legt diesen fest.

R

Ruft den sRGB-Rotkanalwert der Farbe ab oder legt diesen fest.

ScA

Ruft den ScRGB-Alphakanalwert der Farbe ab oder legt diesen fest.

ScB

Ruft den ScRGB-Blaukanalwert der Farbe ab oder legt diesen fest.

ScG

Ruft den ScRGB-Grünkanalwert der Farbe ab oder legt diesen fest.

ScR

Ruft den ScRGB-Rotkanalwert der Farbe ab oder legt diesen fest.

Methoden

Add(Color, Color)

Addiert zwei Color-Strukturen.

AreClose(Color, Color)

Vergleicht zwei Color-Strukturen auf unscharfe Gleichheit.

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.

Equals(Color)

Überprüft, ob die angegebene Color-Struktur mit dieser Farbe identisch ist.

Equals(Color, Color)

Überprüft, ob zwei Color-Strukturen identisch sind.

Equals(Object)

Überprüft, ob das angegebene Objekt eine Color-Struktur ist und dieser Farbe entspricht.

FromArgb(Byte, Byte, Byte, Byte)

Erstellt mithilfe der angegebenen sRGB-Alphakanal- und -Farbkanalwerte eine neue Color-Struktur.

FromAValues(Single, Single[], Uri)

Erstellt mithilfe der angegebenen Alphakanal- und Farbkanalwerte sowie des angegebenen Farbprofils eine neue Color-Struktur.

FromRgb(Byte, Byte, Byte)

Erstellt mithilfe der angegebenen sRGB-Farbkanalwerte eine neue Color-Struktur.

FromScRgb(Single, Single, Single, Single)

Erstellt mithilfe der angegebenen ScRGB-Alphakanal- und -Farbkanalwerte eine neue Color-Struktur.

FromValues(Single[], Uri)

Erstellt mithilfe der angegebenen Farbkanalwerte und des angegebenen Farbprofils eine neue Color-Struktur.

GetHashCode()

Ruft einen Hashcode für die Color-Struktur ab.

GetNativeColorValues()

Ruft die Farbkanalwerte der Farbe ab.

Multiply(Color, Single)

Multipliziert den Alpha-, Rot-, Blau- und Grünkanal der angegebenen Color-Struktur mit dem angegebenen Wert.

Subtract(Color, Color)

Subtrahiert eine Color-Struktur von einer Color-Struktur.

ToString()

Erstellt mithilfe der sRGB-Kanäle eine Zeichenfolgendarstellung der Farbe.

ToString(IFormatProvider)

Erstellt mithilfe der sRGB-Kanäle und des angegebenen Formatanbieters eine Zeichenfolgendarstellung der Farbe.

Operatoren

Addition(Color, Color)

Addiert zwei Color-Strukturen.

Equality(Color, Color)

Überprüft, ob zwei Color-Strukturen identisch sind.

Inequality(Color, Color)

Überprüft, ob zwei Color-Strukturen nicht identisch sind.

Multiply(Color, Single)

Multipliziert den Alpha-, Rot-, Blau- und Grünkanal der angegebenen Color-Struktur mit dem angegebenen Wert.

Subtraction(Color, Color)

Subtrahiert eine Color-Struktur von einer Color-Struktur.

Explizite Schnittstellenimplementierungen

IFormattable.ToString(String, IFormatProvider)

Formatiert den Wert der aktuellen Instanz mit dem angegebenen Format.

Gilt für: