Color Struktur

Referenz

Definition

Namespace:: System.Windows.Media

Assembly:: PresentationCore.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

ValueType
Color

Attribute: TypeConverterAttribute LocalizabilityAttribute

Implementiert: IEquatable<Color> IFormattable

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:

Freigeben über