Elemento DropDownColorPicker

Articolo
06/13/2023

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. 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) 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) 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

Condividi tramite