SplitButtonGallery-Element

Stellt ein Split Button Gallery-Steuerelement mit einem katalogbasierten Dropdownmenü dar.

Verbrauch

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

Attribute

attribute type Erforderlich Beschreibung
ApplicationModes
xs:string
No
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.
Leerraum ist gültig und wird ignoriert.
Maximale Länge: 250 Zeichen.
CommandName
xs:positiveInteger oder xs:string
No
Ordnet das Element einem Command 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 Menüband-XML-Dokuments eindeutig sein.
Maximale Länge: 100 Zeichen.
HasLargeItems
Boolesch
Nein
Bestimmt, ob die große oder kleine Bildressource des Befehls im Katalogsteuerelement angezeigt wird.
[!Note]
Gilt nur für Kataloge, in denen der Wert des Type-Attributs gleich Command ist.

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

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

(Unten)
(Ausblenden)
(Links)
(Überlappung)
(Rechts)
(Oben)
Typ
xs:string
No
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.

SplitButton
Kann ein oder mehrere Male auftreten.

SplitButtonGallery.MenuGroups
Muss genau einmal auftreten

SplitButtonGallery.MenuLayout
Kann höchstens einmal auftreten.

ToggleButton
Kann ein oder mehrere Male auftreten.

Übergeordnete Elemente

Element Beschreibung
ControlGroup
Gruppe
Menugroup
, wenn es in einem ApplicationMenuenthalten ist. Dieses Element wird nur auf der ersten Ebene unterstützt und darf keine untergeordneten Elemente enthalten.

QuickAccessToolbar.ApplicationDefaults
[!Note]
Windows 8 und neuer.


SplitButton

Hinweise

Optional.

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

SplitButtonGallery unterstützt Anwendungsmodi.

Benutzeroberfläche _ PKEY _ BooleanValue wird von einer Anwendung verwendet, um den Umschaltzustand für das Schaltflächensteuerelement eines SplitButtonGallery abzufragen.

Der folgende Screenshot veranschaulicht das Menüband-Steuerelement "Katalog mit geteilten Schaltflächen" in Microsoft Paint für Windows 7.

Screenshot eines Katalogsteuerelements für geteilte Schaltflächen in Microsoft Paint für Windows 7.

Beispiele

Im folgenden Beispiel wird das grundlegende Markup für den Katalog mit geteilten Schaltflächenveranschaulicht.

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

<!-- SplitButtonGallery -->
<Command Name="cmdSplitButtonGalleryGroup"
         Symbol="cmdSplitButtonGalleryGroup"
         Comment="SplitButtonGallery Group"
         LabelTitle="SplitButtonGallery"/>
<Command Name="cmdSplitButtonGallery"
         Symbol="cmdSplitButtonGallery"
         Comment="SplitButtonGallery"
         LabelTitle="SplitButtonGallery"/>

Dieser Codeabschnitt zeigt die SplitButtonGallery-Steuerelementdeklarationen.

<!-- SplitButtonGallery -->
<Group CommandName="cmdSplitButtonGalleryGroup">
  <SplitButtonGallery CommandName="cmdSplitButtonGallery">
    <SplitButtonGallery.MenuLayout>
      <FlowMenuLayout Rows="2"
                      Columns="3"
                      Gripper="None"/>
    </SplitButtonGallery.MenuLayout>
    <SplitButtonGallery.MenuGroups>
      <MenuGroup>
        <Button CommandName="cmdButton1"></Button>
        <Button CommandName="cmdButton2"></Button>
      </MenuGroup>
      <MenuGroup>
        <Button CommandName="cmdButton3"></Button>
      </MenuGroup>
    </SplitButtonGallery.MenuGroups>
  </SplitButtonGallery>
</Group>

Elementinformationen

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

Siehe auch

Split Button Gallery-Steuerelement

Arbeiten mit Katalogen

SetModes

Katalogbeispiel