Freigeben über

DropDownGallery-Element

Stellt ein Dropdownkatalog-Steuerelement mit einem katalogbasierten Menü dar.

Verbrauch

<DropDownGallery
  ApplicationModes = "xs:string"
  CommandName = "xs:positiveInteger or xs:string"
  HasLargeItems = "Boolean"
  ItemHeight = "xs:integer"
  ItemWidth = "xs:integer"
  TextPosition = "TextPositionType"
  Type = "xs:string">
  child elements
</DropDownGallery>

Attribute

attribute type Erforderlich BESCHREIBUNG
ApplicationModes
 xs:string
 Nein
 Nur gültig, wenn MenuGroup das übergeordnete Element ist.

(xs:string)
Eine Zeichenfolge, die eine durch Trennzeichen getrennte Liste von ganzen Zahlen zwischen 0 und 31 enthält.
Leerzeichen sind gültig und werden ignoriert.
Maximale Länge: 250 Zeichen.
CommandName
 xs:positiveInteger oder xs:string
 Nein
 Ordnet das Element einem Command zu.

(xs:positiveInteger oder xs:string)
Eine Zeichenfolge, ein ganzzahliger Wert zwischen 2 und 59999 inklusive oder ein Hexadezimalwert zwischen 0x2 und 0xea5f, inklusive.
Der Wert muss innerhalb des XML-Dokuments des Menübands eindeutig sein.
Maximale Länge: 100 Zeichen.
HasLargeItems
 Boolesch
 Nein
 Bestimmt, ob die große oder kleine Bildressource des Befehls im Katalogsteuerelement angezeigt wird.

Hinweis:
Gilt nur für Kataloge, bei denen der Wert des Type-Attributs gleich Commandist.


Beschränkt auf einen der folgenden Werte (0 und 1 sind ungültig):

(true)
Standard.
(false)
Itemheight
 xs:integer
 Nein
(xs:integer)
Der Standard ist -1.
ItemWidth
 xs:integer
 Nein
(xs:integer)
Der Standard ist -1.
TextPosition
 TextPositionType
 Nein
 Beschränkt auf einen der folgenden Werte:

(Unten)
(Ausblenden)
(Links)
(Überlappung)
(Rechts)
(Oben)
Type
 xs:string
 Nein
 Beschränkt auf einen der folgenden Werte:

(Elemente)
(Befehle)

Untergeordnete Elemente

Element BESCHREIBUNG
Schaltfläche
 Kann ein oder mehrere Male auftreten.
Checkbox
 Kann ein oder mehrere Male auftreten.
DropDownGallery.MenuGroups
 Muss genau einmal auftreten
DropDownGallery.MenuLayout
 Kann höchstens einmal auftreten
SplitButton
 Kann ein oder mehrere Male auftreten.
ToggleButton
 Kann ein oder mehrere Male auftreten.

Übergeordnete Elemente

Element BESCHREIBUNG
ControlGroup
Gruppe
Menugroup
 Wenn in einem Anwendungsmenü enthalten. Dieses Element wird nur auf der ersten Ebene unterstützt und darf keine untergeordneten Elemente aufweisen.
QuickAccessToolbar.ApplicationDefaults
 Hinweis:
Windows 8 und höher.



SplitButton

Hinweise

Optional.

Kann ein oder mehrere Male für jedes ControlGroup-, DropDownButton-, Group-, MenuGroup- oder SplitButton-Element auftreten.

DropDownGallery unterstützt Anwendungsmodi.

Der folgende Screenshot veranschaulicht das Menüband-Dropdownkatalog-Steuerelement in Microsoft Paint für Windows 7.

Screenshot eines Dropdown-Katalogsteuerelements in Microsoft Paint für Windows 7.

Beispiele

Im folgenden Beispiel wird das grundlegende Markup für dropDownGallery veranschaulicht.

Dieser Codeabschnitt zeigt die DropDownGallery-Befehlsdeklarationen mit einer zugeordneten Gruppe , die als übergeordneter Container für das DropDownGallery-Element fungiert.

<!-- DropDownGallery -->
<Command Name="cmdDropDownGalleryGroup"
         Symbol="cmdDropDownGalleryGroup"
         Comment="DropDownGallery Group"
         LabelTitle="DropDownGallery"/>
<Command Name="cmdDropDownGallery"
         Symbol="cmdDropDownGallery"
         Comment="DropDownGallery"
         LabelTitle="DropDownGallery"/>

Dieser Codeabschnitt zeigt die DropDownGallery-Steuerelementdeklarationen .

<!-- DropDownGallery -->
<Group CommandName="cmdDropDownGalleryGroup">
  <DropDownGallery CommandName="cmdDropDownGallery"
                   TextPosition="Hide"
                   Type="Commands"
                   ItemHeight="32"
                   ItemWidth="32">
    <DropDownGallery.MenuLayout>
      <FlowMenuLayout Rows="2"
                      Columns="3"
                      Gripper="None"/>
    </DropDownGallery.MenuLayout>
    <DropDownGallery.MenuGroups>
      <MenuGroup>
        <Button CommandName="cmdButton1"></Button>
        <Button CommandName="cmdButton2"></Button>
       </MenuGroup>
       <MenuGroup>
        <Button CommandName="cmdButton3"></Button>
      </MenuGroup>
    </DropDownGallery.MenuGroups>
  </DropDownGallery>
</Group>

Elementinformationen

  • Unterstützte Mindestsystem: Windows 7
  • Kann leer sein: Nein

Weitere Informationen

Dropdown-Katalogsteuerelement

Arbeiten mit Katalogen

SetModes

Katalogbeispiel

  • Last updated on