Color Struktur

Definition

Beschreibt eine Farbe in Bezug auf Alpha-, Rot-, Grün- und Blaukanäle.

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 sRGB-, ScRGB- und Farbprofilwerte 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

vordefiniertesColor Eine der Von der Colors Klasse vordefinierten Farben.

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

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

rrggbb Eine sechsstellige hexadezimale Zahl. Die ersten beiden Ziffern geben den Wert der Farbe R an, die nächsten beiden 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 nächsten beiden 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

ScaSystem.Single

Der Wert der ScA Farbe.

ScrSystem.Single

Der Wert der ScR Farbe.

ScgSystem.Single

Der Wert der ScG Farbe.

ScbSystem.Single

Der Wert der ScB Farbe.

profileUriSystem.Uri

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

alphaValueSystem.Single

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

ColorvalueSystem.Single

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

Eigenschaften

Name Beschreibung
A

Dient zum Abrufen oder Festlegen des sRGB Alphakanalwerts der Farbe.

B

Dient zum Abrufen oder Festlegen des sRGB blauen Kanalwerts der Farbe.

ColorContext

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

G

Dient zum Abrufen oder Festlegen des sRGB grünen Kanalwerts der Farbe.

R

Dient zum Abrufen oder Festlegen des sRGB Werts des roten Kanals der Farbe.

ScA

Dient zum Abrufen oder Festlegen des ScRGB Alphakanalwerts der Farbe.

ScB

Dient zum Abrufen oder Festlegen des Werts des blauen ScRGB-Kanals der Farbe.

ScG

Dient zum Abrufen oder Festlegen des ScRGB grünen Kanalwerts der Farbe.

ScR

Dient zum Abrufen oder Festlegen des ScRGB Werts des roten Kanals der Farbe.

Methoden

Name Beschreibung
Add(Color, Color)

Fügt zwei Color Strukturen hinzu.

AreClose(Color, Color)

Vergleicht zwei Color Strukturen für Fuzzygleichheit.

Clamp()

Legt die ScRGB Kanäle der Farbe auf die Breite von 0 bis 1 fest, wenn sie sich außerhalb dieses Bereichs befinden.

Equals(Color, Color)

Testet, ob zwei Color Strukturen identisch sind.

Equals(Color)

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

Equals(Object)

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

FromArgb(Byte, Byte, Byte, Byte)

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

FromAValues(Single, Single[], Uri)

Erstellt eine neue Color Struktur mithilfe des angegebenen Alphakanals, Farbkanalwerte und Farbprofils.

FromRgb(Byte, Byte, Byte)

Erstellt eine neue Color Struktur mithilfe der angegebenen sRGB Farbkanalwerte.

FromScRgb(Single, Single, Single, Single)

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

FromValues(Single[], Uri)

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

GetHashCode()

Ruft einen Hashcode für diese Color Struktur ab.

GetNativeColorValues()

Ruft die Farbkanalwerte der Farbe ab.

Multiply(Color, Single)

Multipliziert die Alpha-, Rot-, Blau- und Grünkanäle der angegebenen Color Struktur mit dem angegebenen Wert.

Subtract(Color, Color)

Subtrahiert eine Color Struktur von einer Color Struktur.

ToString()

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

ToString(IFormatProvider)

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

Operatoren

Name Beschreibung
Addition(Color, Color)

Fügt zwei Color Strukturen hinzu.

Equality(Color, Color)

Testet, ob zwei Color Strukturen identisch sind.

Inequality(Color, Color)

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

Multiply(Color, Single)

Multipliziert die Alpha-, Rot-, Blau- und Grünkanäle der angegebenen Color Struktur mit dem angegebenen Wert.

Subtraction(Color, Color)

Subtrahiert eine Color Struktur von einer Color Struktur.

Explizite Schnittstellenimplementierungen

Name Beschreibung
IFormattable.ToString(String, IFormatProvider)

Formatiert den Wert der aktuellen Instanz mithilfe des angegebenen Formats.

Gilt für: