Export (0) Print
Expand All

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

AttributeTypeRequiredDescription

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 emptyYes

See also

Drop-Down Color Picker control
DropDownColorPicker Sample

 

 

Community Additions

ADD
Show:
© 2014 Microsoft