ColorPicker Classe

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Representa um controle que permite que um usuário escolha uma cor usando um espectro de cores, controles deslizantes ou entrada de texto.

Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

/// [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 .../>

Herança

Control

ColorPicker

Atributos

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

Exemplos

Dica

Para obter mais informações, diretrizes de design e exemplos de código, consulte Seletor de cores.

Abra o aplicativo Galeria do WinUI 2 e veja o ColorPicker em ação.

Os aplicativos da Galeria do WinUI 2 incluem exemplos interativos da maioria dos controles, recursos e funcionalidades do WinUI 2. Obtenha o aplicativo na Microsoft Store ou o código-fonte no GitHub.

Comentários

Um seletor de cor é usado para navegar e selecionar cores. Por padrão, ele permite que um usuário navegue pelas cores em um espectro de cores ou especifique um valor de cor Vermelho-Verde-Azul (RGB), Matiz-Saturação-Valor (HSV) ou hexadecimal em uma caixa de texto.

Para obter mais informações sobre o controle ColorPicker, consulte Seletor de cores.

Estilo e modelo de controle

Você pode modificar o Estilo e ControlTemplate padrão para dar ao controle uma aparência exclusiva. Para obter informações sobre como modificar o estilo e o modelo de um controle, consulte Estilos XAML. O estilo, o modelo e os recursos padrão que definem a aparência do controle são incluídos no generic.xaml arquivo. Para fins de design, generic.xaml é instalado com o pacote NuGet WinUI (Microsoft.UI.Xaml). Por padrão, esse local é \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Estilos e recursos de diferentes versões do WinUI podem ter valores diferentes.

O XAML também inclui recursos que você pode usar para modificar as cores de um controle em diferentes estados visuais sem modificar o modelo de controle. É preferível modificar esses recursos para definir propriedades como Plano de Fundo e Primeiro Plano. Para obter mais informações, consulte a seção Estilo leve do artigo Estilos XAML .

Construtores

ColorPicker()

Inicializa uma nova instância da classe ColorPicker. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Propriedades

Color	Obtém ou define o valor de cor atual. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ColorProperty	Identifica a propriedade de dependência Color. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ColorSpectrumComponents	Obtém ou define um valor que indica como os componentes de cor Hue-Saturation-Value (HSV) são mapeados para o ColorSpectrum. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ColorSpectrumComponentsProperty	Identifica a propriedade de dependência ColorSpectrumComponents. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ColorSpectrumShape	Obtém ou define um valor que indica se o ColorSpectrum é mostrado como um quadrado ou um círculo. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ColorSpectrumShapeProperty	Identifica a propriedade de dependência ColorSpectrumShape. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsAlphaEnabled	Obtém ou define um valor que indica se o canal alfa pode ser modificado. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsAlphaEnabledProperty	Identifica a propriedade de dependência IsAlphaEnabled. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsAlphaSliderVisible	Obtém ou define um valor que indica se o controle deslizante do canal alfa é mostrado. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsAlphaSliderVisibleProperty	Identifica a propriedade de dependência IsAlphaSliderVisible. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsAlphaTextInputVisible	Obtém ou define um valor que indica se a caixa de entrada de texto para o canal alfa é mostrada. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsAlphaTextInputVisibleProperty	Identifica a propriedade de dependência IsAlphaTextInputVisible. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsColorChannelTextInputVisible	Obtém ou define um valor que indica se as caixas de entrada de texto para os canais de cores são mostradas. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsColorChannelTextInputVisibleProperty	Identifica a propriedade de dependência IsColorChannelTextInputVisible. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsColorPreviewVisible	Obtém ou define um valor que indica se a barra de visualização de cores é mostrada. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsColorPreviewVisibleProperty	Identifica a propriedade de dependência IsColorPreviewVisible. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsColorSliderVisible	Obtém ou define um valor que indica se o controle deslizante para o valor de cor é mostrado. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsColorSliderVisibleProperty	Identifica a propriedade de dependência IsColorSliderVisible. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsColorSpectrumVisible	Obtém ou define um valor que indica se o controle de espectro de cores é mostrado. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsColorSpectrumVisibleProperty	Identifica a propriedade de dependência IsColorSpectrumVisible. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsHexInputVisible	Obtém ou define um valor que indica se a caixa de entrada de texto para um valor de cor HEX é mostrada. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsHexInputVisibleProperty	Identifica a propriedade de dependência IsHexInputVisible. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsMoreButtonVisible	Obtém ou define um valor que indica se o botão "mais" é mostrado. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsMoreButtonVisibleProperty	Identifica a propriedade de dependência IsMoreButtonVisible. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
MaxHue	Obtém ou define o valor máximo de Hue no intervalo de 0 a 359. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
MaxHueProperty	Identifica a propriedade de dependência MaxHue. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
MaxSaturation	Obtém ou define o valor máximo de Saturação no intervalo de 0 a 100. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
MaxSaturationProperty	Identifica a propriedade de dependência MaxSaturation. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
MaxValue	Obtém ou define o valor máximo de Valor no intervalo de 0 a 100. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
MaxValueProperty	Identifica a propriedade de dependência MaxValue. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
MinHue	Obtém ou define o valor mínimo de Hue no intervalo de 0 a 359. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
MinHueProperty	Identifica a propriedade de dependência MinHue. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
MinSaturation	Obtém ou define o valor mínimo de Saturação no intervalo de 0 a 100. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
MinSaturationProperty	Identifica a propriedade de dependência MinSaturation. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
MinValue	Obtém ou define o valor valor mínimo no intervalo de 0 a 100. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
MinValueProperty	Identifica a propriedade de dependência MinValue. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
Orientation	Obtém ou define a orientação dos controles de edição no ColorPicker. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
OrientationProperty	Identifica a propriedade de dependência Orientation . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
PreviousColor	Obtém ou define a cor anterior. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
PreviousColorProperty	Identifica a propriedade de dependência PreviousColor. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Eventos

ColorChanged

Ocorre quando a propriedade Color foi alterada. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Confira também

• ColorSpectrum
• Seletor de cor