Elemento DropDownColorPicker

  • Artículo

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