ColorPicker Klasse
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.
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).
/// [Microsoft.UI.Xaml.MUXContractProperty(version=5)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
class ColorPicker : Control
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=5)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
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(Microsoft.UI.Xaml.XamlContract, 65536)]
class ColorPicker : Control
[Microsoft.UI.Xaml.MUXContractProperty(version=5)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
public class ColorPicker : Control
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=5)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
public 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
-
ColorPicker
- Attribute
-
Microsoft.UI.Xaml.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute ContractVersionAttribute
Beispiele
Tipp
Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter Farbauswahl.
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). |