É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 : |
| 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) : ![]() La définition de l’attribut ColorTemplate pour ThemeColors active les fonctionnalités suivantes :
![]() La définition de l’attribut ColorTemplate pour StandardColors active les fonctionnalités suivantes :
![]() La définition de l’attribut ColorTemplate pour HighlightColors active les fonctionnalités suivantes :
|
| Colonnes |
xs:positiveInteger |
No |
Nombre de colonnes de la puce de couleur (ou de l’échantillon). |
| CommandName |
XS : positiveInteger ou XS : String |
No |
Associe l’élément à une commande. 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) : |
| 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) : |
| 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 . |
| StandardColorGridRows |
xs:positiveInteger |
No |
Nombre de lignes de puce de couleur (ou d’échantillon) dans la zone de couleurs standard . |
| 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 . |
É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


