Freigeben über

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:

(Klein)
Jeder Farbchip ist ein Quadrat von 11 x 11 Pixeln.
(Mittel)
Jeder Farbchip ist ein Quadrat von 16 x 16 Pixeln.
(Groß)
Jeder Farbchip ist ein Quadrat mit 24 x 24 Pixeln.
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):

(ThemeColors)
Standard.
Screenshot des DropDownColorPicker-Elements, bei dem das ColorTemplate-Attribut auf
Das Festlegen des ColorTemplate-Attributs auf ThemeColors ermöglicht die folgende Funktionalität:
  • SplitButton-Anker.
  • Die Schaltfläche "Automatische Farbe" wird standardmäßig angezeigt.
  • Farbmusterraster für Windows-Designfarben .
  • Farbfeldraster für Standardfarben .
  • Das Raster "Zuletzt verwendete Farben " ist optional.
  • Startprogramm für das Dialogfeld "Weitere Farben ".
  • Standardmäßig wird keine Farbfarbschaltfläche angezeigt.
(StandardColors)
Screenshot des DropDownColorPicker-Elements mit festgelegtem ColorTemplate-Attribut auf
Das Festlegen des ColorTemplate-Attributs auf StandardColors ermöglicht die folgende Funktionalität:
  • SplitButton-Anker.
  • Die Schaltfläche "Automatische Farbe" wird standardmäßig angezeigt.
  • Farbfeldraster für Standardfarben .
  • Startprogramm für das Dialogfeld "Weitere Farben ".
  • Standardmäßig wird keine Farbfarbschaltfläche angezeigt.
(HighlightColors)
Screenshot des DropDownColorPicker-Elements mit festgelegtem ColorTemplate-Attribut auf
Das Festlegen des ColorTemplate-Attributs auf HighlightColors ermöglicht die folgende Funktionalität:
  • SplitButton-Anker.
  • Farbfeldraster für Standardfarben ohne Kopfzeile.
  • Standardmäßig wird keine Farbfarbschaltfläche angezeigt.
Spalten
 xs:positiveInteger
 No
 Die Anzahl von Farbchipspalten (oder Farbfeldspalten).

(xs:positiveInteger)
Ein beliebiger positiver ganzzahliger Wert zwischen 1 und 256, einschließlich.
CommandName
 xs:positiveInteger oder xs:string
 Nein
 Ordnet das Element einem Befehl zu.

(xs:positiveInteger oder xs:string)
Eine Zeichenfolge, ein ganzzahliger Wert zwischen 2 und 59999 einschließlich oder ein Hexadezimalwert zwischen 0x2 und 0xea5f, einschließlich.
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):

(true)
(false)
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):

(true)
(false)
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.

(xs:positiveInteger)
Ein beliebiger positiver ganzzahliger Wert zwischen 1 und 256, einschließlich.
StandardColorGridRows
 xs:positiveInteger
 Nein
 Die Anzahl von Farbchipzeilen (oder Farbfeldzeilen) im Bereich "Standardfarben ".

(xs:positiveInteger)
Ein beliebiger positiver ganzzahliger Wert zwischen 1 und 256, einschließlich.
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.

(xs:positiveInteger)
Ein beliebiger positiver ganzzahliger Wert zwischen 1 und 256, einschließlich.

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

Siehe auch

Dropdown-Steuerelement für die Farbauswahl

DropDownColorPicker-Beispiel