ColorPicker Klasse

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Stellt ein Steuerelement dar, mit dem ein Benutzer eine Farbe mithilfe eines Farbspektrums, Schiebereglers oder einer Texteingabe auswählen kann.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class ColorPicker : Control

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class ColorPicker : Control

Public Class ColorPicker
Inherits Control

<ColorPicker .../>

Vererbung

Control

ColorPicker

Attribute

MarshalingBehaviorAttribute ThreadingAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute ContractVersionAttribute

Beispiele

Tipp

Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter Farbauswahl.

Öffnen Sie die WinUI 2-Katalog-App, und sehen Sie den ColorPicker in Aktion.

Die App WinUI 2-Katalog umfasst interaktive Beispiele für die meisten WinUI 2-Steuerelemente, -Features und -Funktionen. Rufen Sie die App aus dem Microsoft Store oder den Quellcode auf GitHub ab.

Hinweise

Mithilfe eines Farbwählers können Benutzer Farben suchen und auswählen. Standardmäßig können Benutzer durch Farben in einem Farbspektrum navigieren oder einen Rot-Grün-Blau (RGB),Hue-Saturation-Value (HSV) oder hexadezimalen Farbwert in einem Textfeld angeben.

Weitere Informationen zum ColorPicker-Steuerelement finden Sie unter Farbauswahl.

Steuerelementstil und -vorlage

Sie können den Standardstil und die ControlTemplate ändern, um dem Steuerelement ein eindeutiges Erscheinungsbild zu verleihen. Informationen zum Ändern des Stils und der Vorlage eines Steuerelements finden Sie unter XAML-Formatvorlagen. Der Standardstil, die Vorlage und die Ressourcen, die das Erscheinungsbild des Steuerelements definieren, sind in der generic.xaml Datei enthalten. Zu Entwurfszwecken generic.xaml wird mit dem NuGet-Paket WinUI (Microsoft.UI.Xaml) installiert. Standardmäßig ist der Speicherort \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Stile und Ressourcen aus verschiedenen WinUI-Versionen können unterschiedliche Werte aufweisen.

XAML enthält auch Ressourcen, mit denen Sie die Farben eines Steuerelements in verschiedenen visuellen Zuständen ändern können, ohne die Steuerelementvorlage zu ändern. Das Ändern dieser Ressourcen wird bevorzugt, um Eigenschaften wie Hintergrund und Vordergrund festzulegen. Weitere Informationen finden Sie im Abschnitt Leichtes Formatieren des Artikels XAML-Formatvorlagen .

Konstruktoren

ColorPicker()

Initialisiert eine neue instance der ColorPicker-Klasse. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).

Eigenschaften

Color	Ruft den aktuellen Farbwert ab oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
ColorProperty	Gibt die Color-Abhängigkeitseigenschaft an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
ColorSpectrumComponents	Ruft einen Wert ab, der angibt, wie die HsV-Farbkomponenten (Hue-Saturation-Value) dem ColorSpectrum zugeordnet werden, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
ColorSpectrumComponentsProperty	Identifiziert die ColorSpectrumComponents-Abhängigkeitseigenschaft. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
ColorSpectrumShape	Ruft einen Wert ab, der angibt, ob das ColorSpectrum als Quadrat oder Kreis angezeigt wird, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
ColorSpectrumShapeProperty	Gibt die Abhängigkeitseigenschaft ColorSpectrumShape an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
IsAlphaEnabled	Ruft einen Wert ab, der angibt, ob der Alphakanal geändert werden kann, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
IsAlphaEnabledProperty	Gibt die Abhängigkeitseigenschaft IsAlphaEnabled an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
IsAlphaSliderVisible	Ruft einen Wert ab, der angibt, ob das Schiebereglersteuerelement für den Alphakanal angezeigt wird, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
IsAlphaSliderVisibleProperty	Gibt die Abhängigkeitseigenschaft IsAlphaSliderVisible an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
IsAlphaTextInputVisible	Ruft einen Wert ab, der angibt, ob das Texteingabefeld für den Alphakanal angezeigt wird, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
IsAlphaTextInputVisibleProperty	Identifiziert die Abhängigkeitseigenschaft IsAlphaTextInputVisible. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
IsColorChannelTextInputVisible	Ruft einen Wert ab, der angibt, ob die Texteingabefelder für die Farbkanäle angezeigt werden, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
IsColorChannelTextInputVisibleProperty	Gibt die Abhängigkeitseigenschaft IsColorChannelTextInputVisible an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
IsColorPreviewVisible	Ruft einen Wert ab, der angibt, ob die Farbvorschauleiste angezeigt wird, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
IsColorPreviewVisibleProperty	Identifiziert die Abhängigkeitseigenschaft IsColorPreviewVisible. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
IsColorSliderVisible	Ruft einen Wert ab, der angibt, ob das Schiebereglersteuerelement für den Farbwert angezeigt wird, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
IsColorSliderVisibleProperty	Identifiziert die Abhängigkeitseigenschaft IsColorSliderVisible. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
IsColorSpectrumVisible	Ruft einen Wert ab, der angibt, ob das Farbspektrumsteuerelement angezeigt wird, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
IsColorSpectrumVisibleProperty	Gibt die Abhängigkeitseigenschaft IsColorSpectrumVisible an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
IsHexInputVisible	Ruft einen Wert ab, der angibt, ob das Texteingabefeld für einen HEX-Farbwert angezeigt wird, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
IsHexInputVisibleProperty	Identifiziert die Abhängigkeitseigenschaft IsHexInputVisible. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
IsMoreButtonVisible	Ruft einen Wert ab, der angibt, ob die Schaltfläche "Mehr" angezeigt wird, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
IsMoreButtonVisibleProperty	Gibt die Abhängigkeitseigenschaft IsMoreButtonVisible an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
MaxHue	Ruft den maximalen Hue-Wert im Bereich 0-359 ab oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
MaxHueProperty	Gibt die MaxHue-Abhängigkeitseigenschaft an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
MaxSaturation	Ruft den maximalen Sättigungswert im Bereich von 0 bis 100 ab oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
MaxSaturationProperty	Gibt die Abhängigkeitseigenschaft MaxSaturation an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
MaxValue	Ruft den maximalen Wert im Bereich 0-100 ab oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
MaxValueProperty	Identifiziert die MaxValue-Abhängigkeitseigenschaft. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
MinHue	Ruft den minimalen Hue-Wert im Bereich 0 bis 359 ab oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
MinHueProperty	Gibt die MinHue-Abhängigkeitseigenschaft an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
MinSaturation	Ruft den mindesten Sättigungswert im Bereich von 0 bis 100 ab oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
MinSaturationProperty	Gibt die MinSaturation-Abhängigkeitseigenschaft an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
MinValue	Ruft den Minimalwert wert im Bereich 0-100 ab oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
MinValueProperty	Identifiziert die MinValue-Abhängigkeitseigenschaft. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
Orientation	Ruft die Ausrichtung der Bearbeitungssteuerelemente im ColorPicker ab oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
OrientationProperty	Gibt die Orientation-Abhängigkeitseigenschaft an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
PreviousColor	Ruft die vorherige Farbe ab oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
PreviousColorProperty	Identifiziert die PreviousColor-Abhängigkeitseigenschaft. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).

Ereignisse

ColorChanged

Tritt auf, wenn sich die Color-Eigenschaft geändert hat. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).

Weitere Informationen

• ColorSpectrum
• Farbauswahl