Freigeben über

ColorConversionExtensions

  • Artikel

ColorConversionExtensions bieten eine Reihe von Erweiterungsmethoden, die das Konvertieren, Ändern oder Überprüfen von Farben (Colors) unterstützen.

Die ColorConversionExtensions finden Sie unter dem CommunityToolkit.Maui.Core.Extensions-Namespace. Fügen Sie also einfach die folgende Zeile hinzu, um zu beginnen:

using CommunityToolkit.Maui.Core.Extensions;

Konvertieren von Farben

Mit den folgenden Methoden können Sie die Farbe (Color) konvertieren.

ToBlackOrWhite

Die ToBlackOrWhite-Methode konvertiert die Farbe (Color) in einen monochromen Wert (Colors.Black oder Colors.White).

Das folgende Beispiel zeigt, wie Colors.Red in einen monochromen Wert konvertiert wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhite();

ToBlackOrWhiteForText

Die ToBlackOrWhiteForText-Methode wandelt die Farbe (Color) in einen monochromen Wert (Colors.Black oder Colors.White) um, basierend darauf, ob die Farbe (Color) für das menschliche Auge als dunkel eingestuft wird.

Das folgende Beispiel zeigt, wie Colors.Red in einen monochromen Wert konvertiert wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhiteForText();

ToGrayScale

Die ToGrayScale-Methode konvertiert die Farbe (Color) in eine Graustufenfarbe (Color).

Das folgende Beispiel zeigt, wie Colors.Red in einen Graustufenwert konvertiert wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToGrayScale();

ToInverseColor

Die ToInverseColor-Methode kehrt die Farbe (Color) um.

Im folgenden Beispiel wird Colors.Red invertiert:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToInverseColor();

Bestimmen der Farbdunkelheit

Mit den folgenden Methoden können Sie ermitteln, ob die Farbe (Color) als dunkel gilt.

IsDark

Die IsDark-Methode, wenn die Farbe (Color) dunkel ist.

Das folgende Beispiel zeigt, wie Sie ermitteln können, ob Colors.Red als dunkel gilt:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDark();

IsDarkForTheEye

Die IsDarkForTheEye-Methode, wenn die Farbe (Color) für das menschliche Auge dunkel ist.

Das folgende Beispiel zeigt, wie Sie ermitteln können, ob Colors.Red für das menschliche Auge als dunkel gilt:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDarkForTheEye();

Abrufen von Farbkomponenten

Mit den folgenden Methoden können Sie eine der Komponenten der Farbe (Color) abrufen.

GetByteRed

Die GetByteRed-Methode ruft die rote Komponente von Color als Wert zwischen 0 und 255 ab.

Im folgenden Beispiel wird die rote Komponente von Colors.Red abgerufen:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteRed();

GetByteGreen

Die GetByteGreen-Methode ruft die grüne Komponente von Color als Wert zwischen 0 und 255 ab.

Im folgenden Beispiel wird die grüne Komponente von Colors.Red abgerufen:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteGreen();

GetByteBlue

Die GetByteBlue-Methode ruft die blaue Komponente von Color als Wert zwischen 0 und 255 ab.

Im folgenden Beispiel wird die blaue Komponente von Colors.Red abgerufen:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteBlue();

GetDegreeHue

Die GetDegreeHue-Methode ruft die Farbton-Komponente von Color als Wert zwischen 0 und 360 ab.

Im folgenden Beispiel wird die Farbtonkomponente von Colors.Red abgerufen:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetDegreeHue();

GetPercentCyan

Die GetPercentCyan-Methode ruft die Cyan-Komponente von Color als Wert zwischen 0 und 1 ab.

Im folgenden Beispiel wird die Cyan-Komponente von Colors.Red abgerufen:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentCyan();

GetPercentMagenta

Die GetPercentMagenta-Methode ruft die Magenta-Komponente von Color als Wert zwischen 0 und 1 ab.

Im folgenden Beispiel wird die Magenta-Komponente von Colors.Red abgerufen:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentMagenta();

GetPercentYellow

Die GetPercentYellow-Methode ruft die gelbe Komponente von Color als Wert zwischen 0 und 1 ab.

Im folgenden Beispiel wird die gelbe Komponente von Colors.Red abgerufen:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentYellow();

GetPercentBlackKey

Die GetPercentBlackKey-Methode ruft die schwarze Schlüsselkomponente von Color als Wert zwischen 0 und 1 ab.

Im folgenden Beispiel wird die schwarze Schlüsselkomponente von Colors.Red abgerufen:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentBlackKey();

GetByteAlpha

Die GetByteAlpha-Methode ruft die Alpha-Komponente von Color als Wert zwischen 0 und 255 ab.

Im folgenden Beispiel wird die Alpha-Komponente von Colors.Red abgerufen:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteAlpha();

In Farbzeichenfolge

Mit den folgenden Methoden können Sie die Farbe (Color) in eine Farbschemazeichenfolge (string) konvertieren.

ToCmykaString

Die ToCmykaString-Methode konvertiert die Farbe (Color) in eine Zeichenfolge (string), die die Zyan-, Magenta-, Gelb- und Schlüsselkomponente enthält. Die resultierende Zeichenfolge (string) hat das Format CMYKA(cyan,magenta,yellow,key,alpha). Hierbei haben cyan (Zyan), magenta (Magenta), yellow (Gelb) und key (Schlüssel) jeweils einen Wert zwischen 0 und 100 Prozent, und alpha (Alpha) hat einen Wert zwischen 0 und 1 (z. B. CMYKA(0%,100%,100%,0%,1) für Colors.Red).

Im folgenden Beispiel wird gezeigt, wie Colors.Red in eine CMYKA-Zeichenfolge konvertiert wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykaString();

Abhängig von den Kultureinstellungen kann der alpha-Wert unterschiedliche Trennzeichen aufweisen:

new Color(0, 0, 0, 0.5f).ToCmykaString(new System.Globalization.CultureInfo("en-US")); // returns "CMYKA(0%,0%,0%,100%,0.5)"
new Color(0, 0, 0, 0.5f).ToCmykaString(new System.Globalization.CultureInfo("uk-UA")); // returns "CMYKA(0%,0%,0%,100%,0,5)"

ToCmykString

Die ToCmykString-Methode konvertiert die Farbe (Color) in eine Zeichenfolge (string), die die Zyan-, Magenta-, Gelb- und Schlüsselkomponente enthält. Die resultierende Zeichenfolge (string) hat das Format CMYK(cyan,magenta,yellow,key). Hierbei haben cyan (Zyan), magenta (Magenta), yellow (Gelb) und key (Schlüssel) jeweils einen Wert zwischen 0 und 100 Prozent (z. B. CMYK(0%,100%,100%,0%) für Colors.Red).

Im folgenden Beispiel wird gezeigt, wie Colors.Red in eine CMYK-Zeichenfolge konvertiert wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykString();

ToHslaString

Die ToHslaString-Methode konvertiert die Farbe (Color) in eine Zeichenfolge (string), die die Zyan-, Magenta-, Gelb- und Schlüsselkomponente enthält. Die resultierende Zeichenfolge (string) hat das Format HSLA(hue,saturation,lightness,alpha). Hierbei hat hue (Farbton) einen Wert zwischen 0 und 360, saturation (Sättigung) und lightness (Helligkeit) haben einen Wert zwischen 0 und 100 Prozent, und alpha (Alpha) hat einen Wert zwischen 0 und 1 (z. B. HSLA(0,100%,50%,1) für Colors.Red).

Im folgenden Beispiel wird gezeigt, wie Colors.Red in eine HSLA-Zeichenfolge konvertiert wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslaString();

Abhängig von den Kultureinstellungen kann der alpha-Wert unterschiedliche Trennzeichen aufweisen:

new Color(0, 0, 0, 0.5f).ToHslaString(new System.Globalization.CultureInfo("en-US")); // returns "HSLA(0%,0%,0%,100%,0.5)"
new Color(0, 0, 0, 0.5f).ToHslaString(new System.Globalization.CultureInfo("uk-UA")); // returns "HSLA(0%,0%,0%,100%,0,5)"

ToHslString

Die ToHslString-Methode konvertiert die Farbe (Color) in eine Zeichenfolge (string), die die Zyan-, Magenta-, Gelb- und Schlüsselkomponente enthält. Die resultierende Zeichenfolge (string) hat das Format HSL(hue,saturation,lightness). Hierbei hat hue (Farbton) einen Wert zwischen 0 und 360, saturation (Sättigung) und lightness (Helligkeit) haben einen Wert zwischen 0 und 100 Prozent (z. B. HSL(0,100%,50%) für Colors.Red).

Im folgenden Beispiel wird gezeigt, wie Colors.Red in eine HSL-Zeichenfolge konvertiert wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslString();

ToRgbaString

Die ToRgbaString-Methode wandelt die Farbe (Color) in eine Zeichenfolge (string) um, die die Rot-, Grün-, Blau- und Alpha-Komponente enthält. Die resultierende Zeichenfolge (string) hat das Format RGB(red,green,blue,alpha). Hierbei haben red (Rot), green (Grün) und blue (Blau) jeweils einen Wert zwischen 0 und 255, und alpha (Alpha) hat einen Wert zwischen 0 und 1 (z. B. RGBA(255,0,0,1) für Colors.Red).

Im folgenden Beispiel wird gezeigt, wie Colors.Red in eine RGBA-Zeichenfolge konvertiert wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbaString();

Abhängig von den Kultureinstellungen kann der alpha-Wert unterschiedliche Trennzeichen aufweisen:

new Color(0, 0, 0, 0.5f).ToRgbaString(new System.Globalization.CultureInfo("en-US")); // returns "RGBA(0,0,0,0.5)"
new Color(0, 0, 0, 0.5f).ToRgbaString(new System.Globalization.CultureInfo("uk-UA")); // returns "RGBA(0,0,0,0,5)"

ToRgbString

Die ToRgbString-Methode wandelt die Farbe (Color) in eine Zeichenfolge (string) um, die die rote, grüne und blaue Komponente enthält. Die resultierende Zeichenfolge (string) hat das Format RGB(red,green,blue). Hierbei haben red (Rot), green (Grün) und blue (Blau) jeweils einen Wert zwischen 0 und 255 (z. B. RGB(255,0,0) für Colors.Red).

Im folgenden Beispiel wird gezeigt, wie Colors.Red in eine RGB-Zeichenfolge konvertiert wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbString();

Mit Farbkomponenten

Mit den folgenden Methoden können Sie eine der Komponenten der Farbe (Color) ersetzen.

WithRed

Die WithRed-Methode wendet die angegebene redComponent auf die Farbe (Color) an. Hinweis: redComponent kann ein double-Wert zwischen 0 und 1 oder ein byte-Wert zwischen 0 und 255 sein.

Im folgenden Beispiel wird die rote Komponente auf Colors.Red angewendet:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithRed(0.5);

WithGreen

Die WithGreen-Methode wendet die angegebene greenComponent auf die Farbe (Color) an. Hinweis: greenComponent kann ein double-Wert zwischen 0 und 1 oder ein byte-Wert zwischen 0 und 255 sein.

Im folgenden Beispiel wird die grüne Komponente auf Colors.Red angewendet:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithGreen(0.5);

WithBlue

Die WithBlue-Methode wendet die angegebene blueComponent auf die Farbe (Color) an. Hinweis: blueComponent kann ein double-Wert zwischen 0 und 1 oder ein byte-Wert zwischen 0 und 255 sein.

Im folgenden Beispiel wird die blaue Komponente auf Colors.Red angewendet:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlue(0.5);

WithCyan

Die WithCyan-Methode wendet die angegebene cyanComponent auf die Farbe (Color) an. Hinweis: cyanComponent muss ein Wert zwischen 0 und 1 sein.

Im folgenden Beispiel wird die Zyan-Komponente auf Colors.Red angewendet:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithCyan(0.5);

WithMagenta

Die WithMagenta-Methode wendet die angegebene magentaComponent auf die Farbe (Color) an. Hinweis: magentaComponent muss ein Wert zwischen 0 und 1 sein.

Im folgenden Beispiel wird die Magenta-Komponente auf Colors.Red angewendet:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithMagenta(0.5);

WithYellow

Die WithYellow-Methode wendet die angegebene yellowComponent auf die Farbe (Color) an. Hinweis: yellowComponent muss ein Wert zwischen 0 und 1 sein.

Im folgenden Beispiel wird die gelbe Komponente auf Colors.Red angewendet:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithYellow(0.5);

WithBlackKey

Die WithBlackKey-Methode wendet die angegebene blackKeyComponent auf die Farbe (Color) an. Hinweis: blackKeyComponent muss ein Wert zwischen 0 und 1 sein.

Im folgenden Beispiel wird die schwarze Schlüsselkomponente auf Colors.Red angewendet:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlackKey(0.5);

Beispiele

Ein Beispiel für diese Erweiterung in Aktion finden Sie in der Beispielanwendung für das .NET MAUI Community Toolkit.

API

Sie finden den Quellcode für ColorConversionExtensions über das GitHub-Repository für das .NET MAUI Community Toolkit.