Partager via


Élément DropDownColorPicker

Représente un contrôle sélecteur de couleurs de liste déroulantequi, lorsqu’il est cliqué, affiche une palette de nuances de couleurs.

Utilisation

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

Attributs

Attribut Type Obligatoire Description
ChipSize
xs:string
Non
Taille de chaque puce de couleur ou nuancier.
Limité à l’une des valeurs suivantes :

(Petit)
Chaque puce de couleur est un carré de 11x11 pixels.
(Moyen)
Chaque puce de couleur est un carré de 16 x 16 pixels.
(Grande)
Chaque puce de couleur est un carré de 24 x 24 pixels.
ColorTemplate
xs:string
Non
Modèles de disposition qui spécifient le type de sélecteur de couleurs de liste déroulante.
Limité à l’une des valeurs suivantes (si aucun attribut facultatif lié à un ColorTemplate n’est déclaré, l’affichage par défaut s’affiche) :

(ThemeColors)
Par défaut.
Capture d’écran de l’élément DropDownColorPicker avec l’attribut ColorTemplate défini sur « ThemeColors ».
La définition de l’attribut ColorTemplate pour ThemeColors activer les fonctionnalités suivantes :
  • Ancre SplitButton.
  • Le bouton Couleur automatique s’affiche par défaut.
  • Grille de nuance des couleurs du thème Windows.
  • Grille de nuances de couleurs standard .
  • La grille de nuance couleurs récentes est facultative.
  • Lanceur de boîte de dialogue Autres couleurs.
  • Aucun bouton de couleur n’est affiché par défaut.
(StandardColors)
Capture d’écran de l’élément DropDownColorPicker avec l’attribut ColorTemplate défini sur « StandardColors ».
La définition de l’attribut ColorTemplate pour StandardColors activer les fonctionnalités suivantes :
  • Ancre SplitButton.
  • Le bouton Couleur automatique s’affiche par défaut.
  • Grille de nuances de couleurs standard .
  • Lanceur de boîte de dialogue Autres couleurs.
  • Aucun bouton de couleur n’est affiché par défaut.
(HighlightColors)
Capture d’écran de l’élément DropDownColorPicker avec l’attribut ColorTemplate défini sur « HighlightColors ».
La définition de l’attribut ColorTemplate pour HighlightColors activer les fonctionnalités suivantes :
  • Ancre SplitButton.
  • Grille de nuances de couleurs standard sans en-tête.
  • Aucun bouton de couleur n’est affiché par défaut.
Colonnes
xs:positiveInteger
Non
Nombre de colonnes de puce de couleur (ou nuancier).

(xs:positiveInteger)
Toute valeur entière positive comprise entre 1 et 256, inclusivement.
CommandName
xs:positiveInteger ou xs:string
Non
Associe l’élément à une commande.

(xs:positiveInteger ou xs:string)
Chaîne, valeur entière comprise entre 2 et 59999, inclusive, ou valeur hexadécimale comprise entre 0x2 et 0xea5f, inclusive.
La valeur doit être unique dans le document XML du ruban.
Longueur maximale : 100 caractères.
IsAutomaticColorButtonVisible
Boolean
Non
Affiche (ou masque) le bouton Couleur automatique .
Valide uniquement lorsque StandardColors ou ThemeColors est spécifié pour l’attribut ColorTemplate .
Limité à l’une des valeurs suivantes (0 et 1 ne sont pas valides) :

(true)
(false)
IsNoColorButtonVisible
Boolean
Non
Affiche (ou masque) le bouton Aucune couleur .
Valide pour toutes les valeurs ColorTemplate .
Limité à l’une des valeurs suivantes (0 et 1 ne sont pas valides) :

(true)
(false)
RecentColorGridRows
xs:positiveInteger
Non
Nombre de lignes de puce de couleur (ou nuancier) dans la zone Couleurs récentes .
Valide uniquement lorsque ThemeColors est spécifié pour l’attribut ColorTemplate .

(xs:positiveInteger)
Toute valeur entière positive comprise entre 1 et 256, inclusivement.
StandardColorGridRows
xs:positiveInteger
Non
Nombre de lignes de puce de couleur (ou nuancier) dans la zone de couleurs Standard .

(xs:positiveInteger)
Toute valeur entière positive comprise entre 1 et 256, inclusivement.
ThemeColorGridRows
xs:positiveInteger
Non
Nombre de lignes de puce de couleur (ou nuancier) dans la zone Couleurs du thème .
Valide uniquement lorsque ThemeColors est spécifié pour l’attribut ColorTemplate .

(xs:positiveInteger)
Toute valeur entière positive comprise entre 1 et 256, inclus.

Éléments enfants

Il n’y a pas d’éléments enfants.

Éléments parents

Élément
ControlGroup
DropDownButton
DropDownGallery
Groupe
MenuGroup
SplitButton
SplitButtonGallery

Notes

Optionnel.

Peut se produire une ou plusieurs fois pour chaque élément ControlGroup, DropDownButton, DropDownGallery, Group, MenuGroup, SplitButton ou SplitButtonGallery .

Exemples

L’exemple suivant illustre le balisage de base pour les trois types de sélecteur de couleurs de liste déroulante.

Cette section de code affiche les déclarations de commande pour trois éléments 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"/>

Cette section de code présente les trois types de déclarations de contrôle DropDownColorPicker .

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

Informations sur les éléments

  • Système minimum pris en charge : Windows 7
  • Peut être vide : Oui

Voir aussi

Contrôle Sélecteur de couleurs de liste déroulante

DropDownColorPicker, exemple