Élément DropDownColorPicker

Représente un contrôle de Sélecteur de couleurs déroulantqui, lorsque l’utilisateur clique dessus, affiche une palette d’échantillons 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
Copeaux
xs:string
No
Taille de chaque puce ou nuance de couleur.
Limité à l’une des valeurs suivantes :

Small
Chaque puce de couleur est un carré de pixel 11x11.
Médias
Chaque puce de couleur est un carré de 16 x 16 pixels.
Conséquent
Chaque puce de couleur est un carré de pixel 24x24.
ColorTemplate
xs:string
No
Modèles de disposition qui spécifient le type de Sélecteur de couleur déroulant.
Limité à l’une des valeurs suivantes (si aucun attribut facultatif relatif à un ColorTemplate n’est déclaré, la vue par défaut est indiquée) :

(ThemeColors)
Par défaut.
Screen shot of the DropDownColorPicker element with the ColorTemplate attribute set to 'ThemeColors'.
La définition de l’attribut ColorTemplate pour ThemeColors active les fonctionnalités suivantes :
  • Ancre SplitButton.
  • Le bouton couleur automatique est affiché par défaut.
  • Windows thème couleurs du thème .
  • Grille d’échantillons de couleurs standard .
  • La grille des échantillons de couleurs récentes est facultative.
  • Lanceur de boîte de dialogue couleurs supplémentaires .
  • Aucun bouton de couleur de couleur n’est affiché par défaut.
(StandardColors)
Screen shot of the DropDownColorPicker element with the ColorTemplate attribute set to 'StandardColors'.
La définition de l’attribut ColorTemplate pour StandardColors active les fonctionnalités suivantes :
  • Ancre SplitButton.
  • Le bouton couleur automatique est affiché par défaut.
  • Grille d’échantillons de couleurs standard .
  • Lanceur de boîte de dialogue couleurs supplémentaires .
  • Aucun bouton de couleur de couleur n’est affiché par défaut.
(HighlightColors)
Screen shot of the DropDownColorPicker element with the ColorTemplate attribute set to 'HighlightColors'.
La définition de l’attribut ColorTemplate pour HighlightColors active les fonctionnalités suivantes :
  • Ancre SplitButton.
  • Grille d’échantillons de couleurs standard sans en-tête.
  • Aucun bouton de couleur de couleur n’est affiché par défaut.
Colonnes
xs:positiveInteger
No
Nombre de colonnes de la puce de couleur (ou de l’échantillon).

(XS : positiveInteger)
Toute valeur entière positive comprise entre 1 et 256 inclus.
CommandName
XS : positiveInteger ou XS : String
No
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 inclus.
La valeur doit être unique dans le document XML du ruban.
Longueur maximale : 100 caractères.
IsAutomaticColorButtonVisible
Boolean
Non
Affiche (ou masque) le bouton de 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) :

:
fausses
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) :

:
fausses
RecentColorGridRows
xs:positiveInteger
No
Nombre de lignes de la puce de couleur (ou de l’échantillon) 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 inclus.
StandardColorGridRows
xs:positiveInteger
No
Nombre de lignes de puce de couleur (ou d’échantillon) dans la zone de couleurs standard .

(XS : positiveInteger)
Toute valeur entière positive comprise entre 1 et 256 inclus.
ThemeColorGridRows
xs:positiveInteger
No
Nombre de lignes de puce de couleur (ou d’échantillon) dans la zone de couleurs de 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

Remarques

Optionnel.

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

Exemples

L’exemple suivant illustre le balisage de base pour les trois types de sélecteurs de couleurs déroulants.

Cette section de code montre 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 illustre 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 minimal pris en charge: Windows 7
  • Peut être vide: Oui

Voir aussi

Contrôle de sélecteur de couleurs déroulant

Exemple DropDownColorPicker