Élément DropDownColorPicker

Article
06/13/2023

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

Partager via