DropDownColorPicker-Element
Stellt ein Dropdown-Steuerelement für die Farbauswahldar, das beim Klicken eine Palette von Farbfeldern anzeigt.
Verwendung
<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"/>
Attribute
attribute | Typ | Erforderlich | BESCHREIBUNG |
---|---|---|---|
ChipSize |
xs:string |
No |
Die Größe der einzelnen Farbchips oder Farbfelder. Beschränkt auf einen der folgenden Werte: |
ColorTemplate |
xs:string |
Nein |
Layoutvorlagen, die den Typ der Dropdownfarbauswahl angeben. Beschränkt auf einen der folgenden Werte (wenn keine optionalen Attribute im Zusammenhang mit einer ColorTemplate deklariert werden, wird die Standardansicht angezeigt): Das Festlegen des ColorTemplate-Attributs auf ThemeColors ermöglicht die folgende Funktionalität:
Das Festlegen des ColorTemplate-Attributs auf StandardColors ermöglicht die folgende Funktionalität:
Das Festlegen des ColorTemplate-Attributs auf HighlightColors ermöglicht die folgende Funktionalität:
|
Spalten |
xs:positiveInteger |
No |
Die Anzahl von Farbchipspalten (oder Farbfeldspalten). |
CommandName |
xs:positiveInteger oder xs:string |
Nein |
Ordnet das Element einem Befehl zu. Der Wert muss innerhalb des XML-Dokuments des Menübands eindeutig sein. Maximale Länge: 100 Zeichen. |
IsAutomaticColorButtonVisible |
Boolesch |
Nein |
Zeigt die Schaltfläche "Automatische Farbe" an (oder blendet sie aus). Gültig nur, wenn StandardColors oder ThemeColors für das ColorTemplate-Attribut angegeben wird. Beschränkt auf einen der folgenden Werte (0 und 1 sind ungültig): |
IsNoColorButtonVisible |
Boolesch |
Nein |
Zeigt die Schaltfläche Keine Farbe an (oder blendet sie aus). Gültig für alle ColorTemplate-Werte . Beschränkt auf einen der folgenden Werte (0 und 1 sind ungültig): |
RecentColorGridRows |
xs:positiveInteger |
No |
Die Anzahl der Farbchipzeilen (oder Farbfelder) im Bereich Zuletzt verwendete Farben . Gültig nur, wenn ThemeColors für das ColorTemplate-Attribut angegeben wird. |
StandardColorGridRows |
xs:positiveInteger |
Nein |
Die Anzahl von Farbchipzeilen (oder Farbfeldzeilen) im Bereich "Standardfarben ". |
ThemeColorGridRows |
xs:positiveInteger |
Nein |
Die Anzahl der Zeilen von Farbchips (oder Farbfeldern) im Bereich Designfarben . Gültig nur, wenn ThemeColors für das ColorTemplate-Attribut angegeben wird. |
Untergeordnete Elemente
Es gibt keine untergeordneten Elemente.
Übergeordnete Elemente
Element |
---|
ControlGroup |
DropDownButton |
DropDownGallery |
Gruppe |
Menugroup |
SplitButton |
SplitButtonGallery |
Bemerkungen
Optional.
Kann ein oder mehrere Male für jedes ControlGroup-, DropDownButton-, DropDownGallery-, Group-, MenuGroup-, SplitButton- oder SplitButtonGallery-Element auftreten.
Beispiele
Im folgenden Beispiel wird das grundlegende Markup für alle drei Typen der Dropdownfarbauswahl veranschaulicht.
Dieser Codeabschnitt zeigt die Befehlsdeklarationen für drei DropDownColorPicker-Elemente .
<!-- 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"/>
Dieser Codeabschnitt zeigt die drei Typen von DropDownColorPicker-Steuerelementdeklarationen .
<Group CommandName="cmdDropDownColorPickerGroup"
SizeDefinition="ThreeButtons">
<DropDownColorPicker
CommandName="cmdDropDownColorPickerThemeColors"
ColorTemplate="ThemeColors"/>
<DropDownColorPicker
CommandName="cmdDropDownColorPickerStandardColors"
ColorTemplate="StandardColors"/>
<DropDownColorPicker
CommandName="cmdDropDownColorPickerHighlightColors"
ColorTemplate="HighlightColors"
StandardColorGridRows="1"/>
</Group>
Elementinformationen
- Unterstützte Mindestsystem: Windows 7
- Kann leer sein: Ja