Elemento DropDownColorPicker

Rappresenta un controllo Selezione colori a discesache quando si fa clic visualizza una tavolozza di campioni di colore.

Utilizzo

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

Attributi

Attributo Type Obbligatoria Descrizione
ChipSize
xs:string
No
Dimensione di ogni chip di colore o campione.
Limitato a uno dei valori seguenti:

(Piccolo)
Ogni chip di colore è un quadrato di 11x11 pixel.
(medio)
Ogni chip di colore è un quadrato di 16x16 pixel.
(Grande)
Ogni chip di colore è un quadrato di 24x24 pixel.
ColorTemplate
xs:string
No
Modelli di layout che specificano il tipo di selezione colori a discesa.
Limitato a uno dei valori seguenti (se non vengono dichiarati attributi facoltativi correlati a un ColorTemplate , viene visualizzata la visualizzazione predefinita):

(ThemeColors)
Valore predefinito.
Screenshot dell'elemento DropDownColorPicker con l'attributo ColorTemplate impostato su 'ThemeColors'.
L'impostazione dell'attributo ColorTemplate su ThemeColors consente di abilitare le funzionalità seguenti:
  • Ancoraggio SplitButton.
  • Il pulsante colore automatico viene visualizzato per impostazione predefinita.
  • Griglia dei colori del tema di Windows.
  • Griglia campione colori standard .
  • La griglia dei campioni colori recenti è facoltativa.
  • Icona di avvio di più colori della finestra di dialogo.
  • Per impostazione predefinita, non viene visualizzato alcun pulsante colore.
(StandardColors)
Screenshot dell'elemento DropDownColorPicker con l'attributo ColorTemplate impostato su 'StandardColors'.
L'impostazione dell'attributo ColorTemplate su StandardColors consente di abilitare le funzionalità seguenti:
  • Ancoraggio SplitButton.
  • Il pulsante colore automatico viene visualizzato per impostazione predefinita.
  • Griglia campione colori standard .
  • Icona di avvio di più colori della finestra di dialogo.
  • Per impostazione predefinita, non viene visualizzato alcun pulsante colore.
(HighlightColors)
Screenshot dell'elemento DropDownColorPicker con l'attributo ColorTemplate impostato su 'HighlightColors'.
L'impostazione dell'attributo ColorTemplate su HighlightColors consente di abilitare le funzionalità seguenti:
  • Ancoraggio SplitButton.
  • Griglia dei colori standard senza intestazione.
  • Per impostazione predefinita, non viene visualizzato alcun pulsante colore.
Colonne
xs:positiveInteger
No
Numero di colonne chip di colore (o campione).

(xs:positiveInteger)
Qualsiasi valore intero positivo compreso tra 1 e 256 inclusi.
CommandName
xs:positiveInteger o xs:string
No
Associa l'elemento a un oggetto Command.

(xs:positiveInteger o xs:string)
Stringa, un valore intero compreso tra 2 e 59999, inclusi o un valore esadecimale compreso tra 0x2 e 0xea5f, inclusi.
Il valore deve essere univoco all'interno del documento XML della barra multifunzione.
Lunghezza massima: 100 caratteri.
IsAutomaticColorButtonVisible
Boolean
No
Visualizza (o nasconde) il pulsante Colore automatico .
Valido solo quando StandardColors o ThemeColors viene specificato per l'attributo ColorTemplate .
Limitato a uno dei valori seguenti (0 e 1 non sono validi):

(true)
(false)
IsNoColorButtonVisible
Boolean
No
Visualizza (o nasconde) il pulsante Nessun colore .
Valido per tutti i valori ColorTemplate .
Limitato a uno dei valori seguenti (0 e 1 non sono validi):

(true)
(false)
RecentColorGridRows
xs:positiveInteger
No
Numero di righe del chip di colore (o campione) nell'area Colori recenti .
Valido solo quando ThemeColors viene specificato per l'attributo ColorTemplate .

(xs:positiveInteger)
Qualsiasi valore intero positivo compreso tra 1 e 256 inclusi.
StandardColorGridRows
xs:positiveInteger
No
Numero di righe del chip di colore (o campione) nell'area Colori standard .

(xs:positiveInteger)
Qualsiasi valore intero positivo compreso tra 1 e 256 inclusi.
ThemeColorGridRows
xs:positiveInteger
No
Numero di righe del chip di colore (o campione) nell'area Colori tema .
Valido solo quando ThemeColors viene specificato per l'attributo ColorTemplate .

(xs:positiveInteger)
Qualsiasi valore intero positivo compreso tra 1 e 256, incluso.

Elementi figlio

Non ci sono elementi figlio.

Elementi padre

Elemento
ControlGroup
DropDownButton
DropDownGallery
Gruppo
Menugroup
SplitButton
SplitButtonGallery

Commenti

Facoltativa.

Può verificarsi una o più volte per ogni elemento ControlGroup, DropDownButton, DropDownGallery, Group, MenuGroup, SplitButton o SplitButtonGallery.

Esempio

Nell'esempio seguente viene illustrato il markup di base per tutti e tre i tipi di Selezione colori a discesa.

Questa sezione di codice mostra le dichiarazioni di comando per tre elementi 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"/>

Questa sezione di codice mostra i tre tipi di dichiarazioni di controllo DropDownColorPicker .

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

Informazioni sull'elemento

  • Sistema minimo supportato: Windows 7
  • Può essere vuoto: Sì

Vedi anche

Controllo Selezione colori a discesa

Esempio dropDownColorPicker