Elemento DropDownColorPicker

Representa um controle seletor de coressuspenso que, quando clicado, exibe uma paleta de amostras de cores.

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	Type	Obrigatório	Descrição
ChipSize	xs:string	Não	O tamanho de cada chip de cor ou amostra. Restrito a um dos seguintes valores: (Pequeno) Cada chip de cor é um quadrado de 11 x 11 pixels. (Médio) Cada chip de cor é um quadrado de 16 x 16 pixels. (Grande) Cada chip de cor é um quadrado de 24 x 24 pixels.
ColorTemplate	xs:string	No	Modelos de layout que especificam o tipo de Seletor de Cores Suspensa. Restrito a um dos seguintes valores (se nenhum atributo opcional relacionado a um ColorTemplate for declarado, a exibição padrão será mostrada): (ThemeColors) Padrão. Definir o atributo ColorTemplate para ThemeColors habilitar a seguinte funcionalidade: Âncora SplitButton. O botão de cor automática é exibido por padrão. Grade de amostras de cores de tema do Windows. Grade de amostras de cores padrão . A grade de amostras cores recentes é opcional. Inicializador de caixa de diálogo Mais cores. Nenhum botão de cor é exibido por padrão. (StandardColors) Definir o atributo ColorTemplate para StandardColors habilitar a seguinte funcionalidade: Âncora SplitButton. O botão de cor automática é exibido por padrão. Grade de amostras de cores padrão . Inicializador de caixa de diálogo Mais cores. Nenhum botão de cor é exibido por padrão. (HighlightColors) Definir o atributo ColorTemplate para HighlightColors habilitar a seguinte funcionalidade: Âncora SplitButton. Grade de amostras de cores padrão sem cabeçalho. Nenhum botão de cor é exibido por padrão.
Colunas	xs:positiveInteger	No	O número de colunas de chip de cor (ou amostra). (xs:positiveInteger) Qualquer valor inteiro positivo entre 1 e 256, inclusive.
CommandName	xs:positiveInteger ou xs:string	No	Associa o elemento a um Command. (xs:positiveInteger ou xs:string) Uma cadeia de caracteres, um valor inteiro entre 2 e 59999, inclusive ou um valor hexadecimal entre 0x2 e 0xea5f, inclusive. O valor deve ser exclusivo no documento XML da Faixa de Opções. Comprimento máximo: 100 caracteres.
IsAutomaticColorButtonVisible	Boolean	Não	Exibe (ou oculta) o botão Cor automática . Válido somente quando StandardColors ou ThemeColors for especificado para o atributo ColorTemplate . Restrito a um dos seguintes valores (0 e 1 não são válidos): (true) (false)
IsNoColorButtonVisible	Boolean	Não	Exibe (ou oculta) o botão Sem cor . Válido para todos os valores ColorTemplate . Restrito a um dos seguintes valores (0 e 1 não são válidos): (true) (false)
RecentColorGridRows	xs:positiveInteger	Não	O número de linhas de chip de cor (ou amostra) na área Cores recentes . Válido somente quando ThemeColors for especificado para o atributo ColorTemplate . (xs:positiveInteger) Qualquer valor inteiro positivo entre 1 e 256, inclusive.
StandardColorGridRows	xs:positiveInteger	No	O número de linhas de chip de cor (ou amostra) na área Cores padrão . (xs:positiveInteger) Qualquer valor inteiro positivo entre 1 e 256, inclusive.
ThemeColorGridRows	xs:positiveInteger	Não	O número de linhas de chip de cor (ou amostra) na área Cores do tema . Válido somente quando ThemeColors for especificado para o atributo ColorTemplate . (xs:positiveInteger) Qualquer valor inteiro positivo entre 1 e 256, inclusive.

Elementos filho

Não há elementos filho.

Elementos pai

Elemento
ControlGroup
DropDownButton
DropDownGallery
Grupo
Menugroup
SplitButton
SplitButtonGallery

Comentários

Opcional.

Pode ocorrer uma ou mais vezes para cada elemento ControlGroup, DropDownButton, DropDownGallery, Group, MenuGroup, SplitButton ou SplitButtonGallery .

Exemplos

O exemplo a seguir demonstra a marcação básica para todos os três tipos de Seletor de Cores Suspenso.

Esta seção de código mostra as declarações de comando para três 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"/>

Esta seção de código mostra os três tipos de declarações de controle DropDownColorPicker .

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

Informações do elemento

• Sistema mínimo com suporte: Windows 7
• Pode estar vazio: Sim

Confira também

Controle seletor de cores suspenso

Exemplo de DropDownColorPicker