Color Struktur
Definition
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 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
Der Wert der ScA Farbe.
Der Wert der ScR Farbe.
Der Wert der ScG Farbe.
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 |
| B |
Dient zum Abrufen oder Festlegen des |
| ColorContext |
Ruft das International Color Consortium (ICC) oder das ICM-Farbprofil (Image Color Management) der Farbe ab. |
| G |
Dient zum Abrufen oder Festlegen des |
| R |
Dient zum Abrufen oder Festlegen des |
| ScA |
Dient zum Abrufen oder Festlegen des |
| ScB |
Dient zum Abrufen oder Festlegen des Werts des blauen ScRGB-Kanals der Farbe. |
| ScG |
Dient zum Abrufen oder Festlegen des |
| ScR |
Dient zum Abrufen oder Festlegen des |
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 |
| 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 |
| 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 |
| FromScRgb(Single, Single, Single, Single) |
Erstellt eine neue Color Struktur mithilfe der angegebenen |
| 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) | |
| ToString() |
Erstellt eine Zeichenfolgendarstellung der Farbe mithilfe der |
| ToString(IFormatProvider) |
Erstellt eine Zeichenfolgendarstellung der Farbe mithilfe der |
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) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IFormattable.ToString(String, IFormatProvider) |
Formatiert den Wert der aktuellen Instanz mithilfe des angegebenen Formats. |