DropDownColorPicker element

Represents a Drop-Down Color Pickercontrol that when clicked displays a palette of color swatches.

Usage

<DropDownColorPicker
  CommandName = "xs:positiveInteger or xs:string"
  Columns = "xs:positiveInteger"
  ThemeColorGridRows = "xs:positiveInteger"
  StandardColorGridRows = "xs:positiveInteger"
  RecentColorGridRows = "xs:positiveInteger"
  IsAutomaticColorButtonVisible = "Boolean"
  IsNoColorButtonVisible = "Boolean"
  ColorTemplate = "xs:string"
  ChipSize = "xs:string"/>

Attributes

Attribute Type Required Description
ChipSize
xs:string
No
The size of each color chip or swatch.
Restricted to one of the following values:

(Small)
Each color chip is an 11x11 pixel square.
(Medium)
Each color chip is a 16x16 pixel square.
(Large)
Each color chip is a 24x24 pixel square.
ColorTemplate
xs:string
No
Layout templates that specify the type of Drop-Down Color Picker.
Restricted to one of the following values (if no optional attributes related to a ColorTemplate are declared, the default view is shown):

(ThemeColors)
Default.
Screen shot of the DropDownColorPicker element with the ColorTemplate attribute set to 'ThemeColors'.
Setting the ColorTemplate attribute to ThemeColors enables the following functionality:
  • SplitButton anchor.
  • Automatic color button is displayed by default.
  • Windows Theme colors swatch grid.
  • Standard colors swatch grid.
  • Recent Colors swatch grid is optional.
  • More colors dialog box launcher.
  • No color color button is displayed by default.
(StandardColors)
Screen shot of the DropDownColorPicker element with the ColorTemplate attribute set to 'StandardColors'.
Setting the ColorTemplate attribute to StandardColors enables the following functionality:
  • SplitButton anchor.
  • Automatic color button is displayed by default.
  • Standard colors swatch grid.
  • More colors dialog box launcher.
  • No color color button is displayed by default.
(HighlightColors)
Screen shot of the DropDownColorPicker element with the ColorTemplate attribute set to 'HighlightColors'.
Setting the ColorTemplate attribute to HighlightColors enables the following functionality:
  • SplitButton anchor.
  • Standard colors swatch grid with no header.
  • No color color button is displayed by default.
Columns
xs:positiveInteger
No
The number of color chip (or swatch) columns.

(xs:positiveInteger)
Any positive integer value between 1 and 256, inclusive.
CommandName
xs:positiveInteger or xs:string
No
Associates the element with a Command.

(xs:positiveInteger or xs:string)
A string, an integer value between 2 and 59999, inclusive, or a hexadecimal value between 0x2 and 0xea5f, inclusive.
The value must be unique within the Ribbon XML document.
Maximum length: 100 characters.
IsAutomaticColorButtonVisible
Boolean
No
Displays (or hides) the Automatic color button.
Valid only when StandardColors or ThemeColors is specified for the ColorTemplate attribute.
Restricted to one of the following values (0 and 1 are not valid):

(true)
(false)
IsNoColorButtonVisible
Boolean
No
Displays (or hides) the No color button.
Valid for all ColorTemplate values.
Restricted to one of the following values (0 and 1 are not valid):

(true)
(false)
RecentColorGridRows
xs:positiveInteger
No
The number of color chip (or swatch) rows in the Recent colors area.
Valid only when ThemeColors is specified for the ColorTemplate attribute.

(xs:positiveInteger)
Any positive integer value between 1 and 256, inclusive.
StandardColorGridRows
xs:positiveInteger
No
The number of color chip (or swatch) rows in the Standard colors area.

(xs:positiveInteger)
Any positive integer value between 1 and 256, inclusive.
ThemeColorGridRows
xs:positiveInteger
No
The number of color chip (or swatch) rows in the Theme colors area.
Valid only when ThemeColors is specified for the ColorTemplate attribute.

(xs:positiveInteger)
Any positive integer value between 1 and 256, inclusive.

Child elements

There are no child elements.

Parent elements

Element
ControlGroup
DropDownButton
DropDownGallery
Group
MenuGroup
SplitButton
SplitButtonGallery

Remarks

Optional.

May occur one or more times for each ControlGroup, DropDownButton, DropDownGallery, Group, MenuGroup, SplitButton, or SplitButtonGallery element.

Examples

The following example demonstrates the basic markup for all three types of Drop-Down Color Picker.

This section of code shows the Command declarations for three DropDownColorPicker elements.

<!-- DropDownColorPickers -->
<Command Name="cmdDropDownColorPickerGroup"
         Symbol="cmdDropDownColorPickerGroup"
         Comment="DropDownColorPicker Group"
         Id="55000"/>
<Command Name="cmdDropDownColorPickerThemeColors"
         Symbol="cmdDropDownColorPickerThemeColors"
         Comment="DropDownColorPicker ThemeColors"
         Id="55010"
         LabelTitle="ThemeColors"
         LabelDescription="ThemeColors\ndescription."/>
<Command Name="cmdDropDownColorPickerStandardColors"
         Symbol="cmdDropDownColorPickerStandardColors"
         Comment="DropDownColorPicker StandardColors"
         Id="55011"
         LabelTitle="StandardColors"/>
<Command Name="cmdDropDownColorPickerHighlightColors"
         Symbol="cmdDropDownColorPickerHighlightColors"
         Comment="DropDownColorPicker HighlightColors"
         Id="55012"
         LabelTitle="HighlightColors"/>

This section of code shows the three types of DropDownColorPicker control declarations.

<Group CommandName="cmdDropDownColorPickerGroup"
       SizeDefinition="ThreeButtons">
  <DropDownColorPicker
    CommandName="cmdDropDownColorPickerThemeColors"
    ColorTemplate="ThemeColors"/>
  <DropDownColorPicker
    CommandName="cmdDropDownColorPickerStandardColors"
    ColorTemplate="StandardColors"/>
  <DropDownColorPicker
    CommandName="cmdDropDownColorPickerHighlightColors"
    ColorTemplate="HighlightColors"
    StandardColorGridRows="1"/>
</Group>

Element information

  • Minimum supported system: Windows 7
  • Can be empty: Yes

See also

Drop-Down Color Picker control

DropDownColorPicker Sample