Compartir a través de


Elemento DropDownColorPicker

Representa un control Selector de color desplegableque cuando se hace clic en muestra una paleta de muestras de color.

Uso

<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"/>

Atributos

Atributo Tipo Requerido Descripción
ChipSize
xs:string
No
Tamaño de cada chip de color o muestra.
Restringido a uno de los siguientes valores:

(Pequeño)
Cada chip de color es un cuadrado de 11 x 11 píxeles.
(Medio)
Cada chip de color es un cuadrado de 16 x 16 píxeles.
(Grande)
Cada chip de color es un cuadrado de 24 x 24 píxeles.
ColorTemplate
xs:string
No
Plantillas de diseño que especifican el tipo de Selector de color desplegable.
Restringido a uno de los siguientes valores (si no se declaran atributos opcionales relacionados con un ColorTemplate , se muestra la vista predeterminada):

(ThemeColors)
Predeterminada.
Captura de pantalla del elemento DropDownColorPicker con el atributo ColorTemplate establecido en
Establecer el atributo ColorTemplate en ThemeColors habilita la funcionalidad siguiente:
  • Delimitador SplitButton.
  • El botón color automático se muestra de forma predeterminada.
  • Cuadrícula de muestra de colores del tema de Windows.
  • Cuadrícula de muestra de colores estándar.
  • La cuadrícula de muestra de colores recientes es opcional.
  • Selector de cuadros de diálogo Más colores.
  • No se muestra ningún botón de color de forma predeterminada.
(StandardColors)
Captura de pantalla del elemento DropDownColorPicker con el atributo ColorTemplate establecido en
Establecer el atributo ColorTemplate en StandardColors habilita la funcionalidad siguiente:
  • Delimitador SplitButton.
  • El botón color automático se muestra de forma predeterminada.
  • Cuadrícula de muestra de colores estándar.
  • Selector de cuadros de diálogo Más colores.
  • No se muestra ningún botón de color de forma predeterminada.
(HighlightColors)
Captura de pantalla del elemento DropDownColorPicker con el atributo ColorTemplate establecido en
Establecer el atributo ColorTemplate en HighlightColors habilita la funcionalidad siguiente:
  • Delimitador SplitButton.
  • Cuadrícula de muestra de colores estándar sin encabezado.
  • No se muestra ningún botón de color de forma predeterminada.
Columnas
xs:positiveInteger
No
Número de columnas de chip de color (o muestra).

(xs:positiveInteger)
Cualquier valor entero positivo entre 1 y 256, ambos incluidos.
CommandName
xs:positiveInteger o xs:string
No
Asocia el elemento a un objeto Command.

(xs:positiveInteger o xs:string)
Una cadena, un valor entero entre 2 y 59999, inclusive o un valor hexadecimal entre 0x2 y 0xea5f, ambos incluidos.
El valor debe ser único dentro del documento XML de la cinta de opciones.
Longitud máxima: 100 caracteres.
IsAutomaticColorButtonVisible
Boolean
No
Muestra (u oculta) el botón Color automático .
Válido solo cuando StandardColors se especifica o ThemeColors para el atributo ColorTemplate .
Restringido a uno de los valores siguientes (0 y 1 no son válidos):

(true)
(false)
IsNoColorButtonVisible
Boolean
No
Muestra (u oculta) el botón No color .
Válido para todos los valores de ColorTemplate .
Restringido a uno de los valores siguientes (0 y 1 no son válidos):

(true)
(false)
RecentColorGridRows
xs:positiveInteger
No
Número de filas de chip de color (o muestra) en el área Colores recientes .
Válido solo cuando ThemeColors se especifica para el atributo ColorTemplate .

(xs:positiveInteger)
Cualquier valor entero positivo entre 1 y 256, ambos incluidos.
StandardColorGridRows
xs:positiveInteger
No
Número de filas de chip de color (o muestra) en el área Colores estándar .

(xs:positiveInteger)
Cualquier valor entero positivo entre 1 y 256, ambos incluidos.
ThemeColorGridRows
xs:positiveInteger
No
Número de filas de chip de color (o muestra) en el área Colores del tema .
Válido solo cuando ThemeColors se especifica para el atributo ColorTemplate .

(xs:positiveInteger)
Cualquier valor entero positivo entre 1 y 256, ambos incluidos.

Elementos secundarios

No hay elementos secundarios.

Elementos primarios

Elemento
ControlGroup
DropDownButton
DropDownGallery
Group (Grupo)
MenuGroup
SplitButton
SplitButtonGallery

Observaciones

Opcional.

Puede producirse una o varias veces para cada elemento ControlGroup, DropDownButton, DropDownGallery, Group, MenuGroup, SplitButton o SplitButtonGallery .

Ejemplos

En el ejemplo siguiente se muestra el marcado básico para los tres tipos de Selector de colores desplegables.

En esta sección de código se muestran las declaraciones command de tres elementos DropDownColorPicker .

<!-- 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"/>

En esta sección de código se muestran los tres tipos de declaraciones de control DropDownColorPicker .

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

Información de elemento

  • Sistema mínimo admitido: Windows 7
  • Puede estar vacío: Sí

Vea también

Control Selector de colores desplegable

Ejemplo dropDownColorPicker