ColorConversionExtensions

Die ColorConversionExtensions stellen eine Reihe von Erweiterungsmethoden bereit, die das Konvertieren, Ändern oder Überprüfen von Color-Objekten unterstützen.

Das ColorConversionExtensions finden Sie im Namespace CommunityToolkit.Maui.Core.Extensions, fügen Sie also einfach die folgende Zeile hinzu, um loszulegen:

using CommunityToolkit.Maui.Core.Extensions;

Farben konvertieren

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

ToBlackOrWhite

Die Methode ToBlackOrWhite wandelt Color in einen Monochromwert mit dem Wert Colors.Black oder Colors.White um.

Das folgende Beispiel zeigt, wie Sie in einen Monochromwert konvertieren Colors.Red :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhite();

ToBlackOrWhiteForText

Die Methode ToBlackOrWhiteForText konvertiert das Color in einen monochromen Wert von Colors.Black oder Colors.White, je nachdem, ob Color für das menschliche Auge als dunkel wahrgenommen wird.

Das folgende Beispiel zeigt, wie Sie in einen Monochromwert konvertieren Colors.Red :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhiteForText();

ToGrayScale

Die Methode ToGrayScale wandelt Color in eine Graustufen-Color um.

Das folgende Beispiel zeigt, wie Sie Colors.Red in einen Graustufenwert konvertieren:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToGrayScale();

ToInverseColor

Die ToInverseColor Methode umkehrt die Color.

Das folgende Beispiel zeigt, wie Sie Colors.Red invertieren:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToInverseColor();

Bestimmung der Dunkelheit einer Farbe

Mit den folgenden Methoden können Sie ermitteln, ob dies Color als dunkel eingestuft wird.

IsDark

Die IsDark-Methode, wenn Color dunkel ist.

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

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDark();

IsDarkForTheEye

Die IsDarkForTheEye-Methode, wenn das 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 betrachtet wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDarkForTheEye();

Farbkomponenten abrufen

Mit den folgenden Methoden können Sie eine der Komponenten von Color erhalten.

GetByteRed

Die Methode GetByteRed gibt die rote Komponente von Color als einen Wert zwischen 0 und 255 zurück.

Das folgende Beispiel zeigt, wie Sie den Rotanteil von Colors.Red abrufen:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteRed();

GetByteGreen

Die Methode GetByteGreen gibt die grüne Komponente von Color als Wert zwischen 0 und 255 zurück.

Das folgende Beispiel zeigt, wie die grüne Komponente aus Colors.Red abgerufen wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteGreen();

GetByteBlue

Die GetByteBlue Methode gibt die blaue Komponente von Color als einen Wert zwischen 0 und 255 zurück.

Das folgende Beispiel zeigt, wie die Blaukomponente von Colors.Red abgerufen wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteBlue();

GetDegreeHue

Die Methode GetDegreeHue gibt die Farbtonkomponente von Color als Wert zwischen 0 und 360 zurück.

Das folgende Beispiel zeigt, wie die Farbtonkomponente von Colors.Red abgerufen wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetDegreeHue();

GetPercentCyan

Die GetPercentCyan Methode ruft die Cyan-KomponenteColor als Wert zwischen 0 und 1 ab.

Das folgende Beispiel zeigt, wie die Cyan-Komponente von Colors.Red abgerufen wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentCyan();

GetPercentMagenta

Die Methode GetPercentMagenta gibt die Magenta-Komponente von Color als Wert zwischen 0 und 1 zurück.

Das folgende Beispiel zeigt, wie die Magenta-Komponente von Colors.Red abgerufen wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentMagenta();

GetPercentYellow

Die Methode GetPercentYellow gibt die gelbe Komponente von Color als einen Wert zwischen 0 und 1 zurück.

Das folgende Beispiel zeigt, wie die gelbe Komponente von Colors.Red abgerufen wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentYellow();

GetPercentBlackKey

Die GetPercentBlackKey Methode ruft die Schwarze SchlüsselkomponenteColor als Wert zwischen 0 und 1 ab.

Das folgende Beispiel zeigt, wie Sie die Black-Key-Komponente von Colors.Red abrufen:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentBlackKey();

GetByteAlpha

Die Methode GetByteAlpha gibt die alpha-Komponente von Color als einen Wert zwischen 0 und 255 zurück.

Das folgende Beispiel zeigt, wie die Alphakomponente von Colors.Red abgerufen wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteAlpha();

In Farbzeichenfolge umwandeln

Mit den folgenden Methoden können Sie das Color Farbschema in ein Farbschema stringkonvertieren.

ToCmykaString

Die Methode ToCmykaString konvertiert Color in ein string, das die Zyan-, Magenta-, Gelb- und Schwarzanteile enthält. Das Ergebnis string ist in dem Format: CMYKA(cyan,magenta,yellow,key,alpha) Wobei Zyan, Magenta, Gelb und Schlüssel ein Wert zwischen 0% und 100%sein, und Alpha wird ein Wert zwischen 0 und 1 (z. B. CMYKA(0%,100%,100%,0%,1) für Colors.Red).

Das folgende Beispiel zeigt, wie Sie in eine CMYKA-Zeichenfolge konvertieren Colors.Red :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykaString();

Abhängig von den Kultureinstellungen kann der Alphawert unterschiedliche Delimeter 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 Methode ToCmykString wandelt das Color in ein string um, das die Cyan-, Magenta-, Gelb- und Schwarzkomponenten enthält. Das Ergebnis string wird im Format vorliegen: CMYK(cyan,magenta,yellow,key) Dabei wird Zyan, Magenta, Gelb und Schlüssel ein Wert zwischen 0% und 100% (z. B. CMYK(0%,100%,100%,0%) für Colors.Red).

Das folgende Beispiel zeigt, wie Sie in eine CMYK-Zeichenfolge konvertieren Colors.Red :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykString();

ToHslaString

Die Methode ToHslaString konvertiert Color in ein string, das die Cyan-, Magenta-, Gelb- und Schwarzkomponenten enthält. Das resultierende string hat das Format: HSLA(hue,saturation,lightness,alpha), wobei Farbton ein Wert zwischen 0 und 360 ist, Sättigung und Sättigung Werte zwischen 0 % und 100 % sind und alpha ein Wert zwischen 0 und 1 ist (z. B. HSLA(0,100%,50%,1) für Colors.Red).

Das folgende Beispiel zeigt, wie Sie in eine HSLA-Zeichenfolge konvertieren Colors.Red :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslaString();

Abhängig von den Kultureinstellungen kann der Alphawert unterschiedliche Delimeter 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 Methode ToHslString konvertiert Color in ein string, das die Komponenten Cyan, Magenta, Gelb und Schwarz enthält. Das resultierende string hat das Format: HSL(hue,saturation,lightness), wobei Farbton ein Wert zwischen 0 und 360 ist und Sättigung sowie Sättigung Werte zwischen 0 % und 100 % sind (z. B. HSL(0,100%,50%) für Colors.Red).

Das folgende Beispiel zeigt, wie Sie in eine HSL-Zeichenfolge konvertieren Colors.Red :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslString();

ToRgbaString

Die Methode ToRgbaString konvertiert Color in ein string, das die Rot-, Grün-, Blau- und Alpha-Komponenten enthält. Das Ergebnis string ist das Format: RGB(red,green,blue,alpha) Dabei wird rot, grün und blau ein Wert zwischen 0 und 255 und Alpha ein Wert zwischen 0 und 1 (z. B. RGBA(255,0,0,1) für Colors.Red).

Das folgende Beispiel zeigt, wie Colors.Red in eine RGBA-Zeichenfolge konvertiert wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbaString();

Abhängig von den Kultureinstellungen kann der Alphawert unterschiedliche Delimeter 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 Methode ToRgbString wandelt Color in ein string um, das die Rot-, Grün- und Blaukomponenten enthält. Das Ergebnis string wird im Format vorliegen: RGB(red,green,blue) Dabei ist rot, grün und blau ein Wert zwischen 0 und 255 (z. B. RGB(255,0,0) für Colors.Red).

Das folgende Beispiel zeigt, wie Colors.Red in einen RGB-String konvertiert wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbString();

Mit Farbkomponenten

Mit den folgenden Methoden können Sie eine der Komponenten von Color ersetzen.

MitRed

Die Methode WithRed wendet die übergebene redComponent auf die Color an. Beachten Sie, dass dies redComponent zwischen double 0 und 1 oder zwischen byte 0 und 255 sein kann.

Das folgende Beispiel zeigt, wie die rote Komponente auf Colors.Red angewendet wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithRed(0.5);

WithGreen

Die WithGreen-Methode wendet die übergebene greenComponent auf die Color an. Beachten Sie, dass dies greenComponent zwischen double 0 und 1 oder zwischen byte 0 und 255 sein kann.

Das folgende Beispiel zeigt, wie die grüne Komponente auf Colors.Red angewendet wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithGreen(0.5);

WithBlue

Die WithBlue-Methode wendet die übergebene blueComponent auf die Color an. Beachten Sie, dass dies blueComponent zwischen double 0 und 1 oder zwischen byte 0 und 255 sein kann.

Das folgende Beispiel zeigt, wie man die blaue Komponente auf Colors.Red anwendet:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlue(0.5);

WithCyan

Die WithCyanMethode wendet die übergebene cyanComponent auf die Color an. Beachten Sie, dass dies cyanComponent ein Wert zwischen 0 und 1 sein muss.

Das folgende Beispiel zeigt, wie die Cyan-Komponente auf Colors.Red angewendet wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithCyan(0.5);

WithMagenta

Die Methode WithMagenta wendet das angegebene magentaComponent auf das Color an. Beachten Sie, dass dies magentaComponent ein Wert zwischen 0 und 1 sein muss.

Das folgende Beispiel zeigt, wie die Magenta-Komponente auf Colors.Red angewendet wird:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithMagenta(0.5);

WithYellow

Die Methode WithYellow wendet die angegebene yellowComponent auf Color an. Beachten Sie, dass dies yellowComponent ein Wert zwischen 0 und 1 sein muss.

Das folgende Beispiel zeigt, wie Sie die gelbe Komponente auf Colors.Red anwenden:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithYellow(0.5);

WithBlackKey

Die Methode WithBlackKey wendet die übergebene blackKeyComponent auf die Color an. Beachten Sie, dass dies blackKeyComponent ein Wert zwischen 0 und 1 sein muss.

Das folgende Beispiel zeigt, wie Sie die Komponente „schwarze Taste“ auf Colors.Red anwenden:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlackKey(0.5);

Beispiele

Sie finden ein Beispiel für diese Erweiterung in Aktion im .NET MAUI Community Toolkit Sample Application.

API

Sie finden den Quellcode für ColorConversionExtensions im .NET MAUI Community Toolkit GitHub Repository.