ColorView

Presents a color for user editing using a spectrum, palette and component sliders.

Common Properties

Property	Description
Color	Gets or sets the currently selected color in the RGB color model. For control authors, use HsvColor instead to avoid loss of precision and color drifting.
ColorModel	Gets or sets the active color model used by the sliders. This property is only applicable to the components tab. The spectrum tab must always be in HSV and the palette tab contains only pre-defined colors.
ColorSpectrumComponents	Gets or sets the two HSV color components displayed by the spectrum.
ColorSpectrumShape	Gets or sets the displayed shape of the spectrum.
HexInputAlphaPosition	Gets or sets the position of the alpha component in the hexadecimal input box relative to all other color components.
HsvColor	Gets or sets the currently selected color in the HSV color model. This should be used in all cases instead of the Color property. Internally, the ColorSpectrum uses the HSV color model and using this property will avoid loss of precision and color drifting.
IsAccentColorsVisible	Gets or sets a value indicating whether accent colors are visible along with the preview color.
IsAlphaEnabled	Gets or sets a value indicating whether the alpha component is enabled. When disabled (set to false) the alpha component will be fixed to maximum and editing controls disabled.
IsAlphaVisible	Gets or sets a value indicating whether the alpha component editing controls (Slider(s) and TextBox) are visible. When hidden, the existing alpha component value is maintained. Note that IsComponentTextInputVisible also controls the alpha component TextBox visibility.
IsColorComponentsVisible	Gets or sets a value indicating whether the color components tab/panel/page (subview) is visible.
IsColorModelVisible	Gets or sets a value indicating whether the active color model indicator/selector is visible.
IsColorPaletteVisible	Gets or sets a value indicating whether the color palette tab/panel/page (subview) is visible.
IsColorPreviewVisible	Gets or sets a value indicating whether the color preview is visible. Note that accent color visibility is controlled separately by IsAccentColorsVisible.
IsColorSpectrumVisible	Gets or sets a value indicating whether the color spectrum tab/panel/page (subview) is visible.
IsColorSpectrumSliderVisible	Gets or sets a value indicating whether the color spectrum's third component slider is visible.
IsComponentSliderVisible	Gets or sets a value indicating whether color component sliders are visible. All color components are controlled by this property but alpha can also be controlled with IsAlphaVisible.
IsComponentTextInputVisible	Gets or sets a value indicating whether color component text inputs are visible. All color components are controlled by this property but alpha can also be controlled with IsAlphaVisible.
IsHexInputVisible	Gets or sets a value indicating whether the hexadecimal color value text input is visible.
MaxHue	Gets or sets the maximum value of the Hue component in the range from 0..359. This property must be greater than MinHue.
MaxSaturation	Gets or sets the maximum value of the Saturation component in the range from 0..100. This property must be greater than MinSaturation.
MaxValue	Gets or sets the maximum value of the Value component in the range from 0..100. This property must be greater than MinValue.
MinHue	Gets or sets the minimum value of the Hue component in the range from 0..359. This property must be less than MaxHue.
MinSaturation	Gets or sets the minimum value of the Saturation component in the range from 0..100. This property must be less than MaxSaturation.
MinValue	Gets or sets the minimum value of the Value component in the range from 0..100. This property must be less than MaxValue.
PaletteColors	Gets or sets the collection of individual colors in the palette. This is not commonly set manually. Instead, it should be set automatically by providing an IColorPalette to the Palette property.
PaletteColumnCount	Gets or sets the number of colors in each row (section) of the color palette. Within a standard palette, rows are shades and columns are colors. This is not commonly set manually. Instead, it should be set automatically by providing an IColorPalette to the Palette property.
Palette	Gets or sets the color palette. This will automatically set both PaletteColors and PaletteColumnCount overwriting any existing values.
SelectedIndex	Gets or sets the index of the selected tab/panel/page (subview). When using the default control theme, this property is designed to be used with the ColorViewTab enum. The ColorViewTab enum defines the index values of each of the three standard tabs. Use like SelectedIndex = (int)ColorViewTab.Palette.

备注

The properties for visibility use the naming pattern "IsThingVisible" rather than "ShowThing" because some elements of the UI have the ability to control both enabled and visible status separately. Naming also matches Control in this case.

Pseudoclasses

None

Template Parts

Name	Type	Description
PART_HexTextBox	TextBox	Provides an input or output for hexadecimal color notation that can be parsed by the control.
PART_TabControl	TabControl	The main control used to navigate through the spectrum, palette and components tab/panel/page (subviews). This template part is optional and is only required for some validation scenarios of the SelectedIndex.