SplitButtonGallery-Element

Artikel
08/14/2024

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	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 `Command`ist. 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.
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 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 für jedes ControlGroup-, Group-, MenuGroup- oder SplitButton-Element ein oder mehrere Male auftreten.

SplitButtonGallery unterstützt Anwendungsmodi.

UI_PKEY_BooleanValue wird von einer Anwendung verwendet, um den Umschaltmodus für das Schaltflächensteuerelement einer SplitButtonGallery abzufragen.

Der folgende Screenshot veranschaulicht das Menüband-Steuerelement "Katalog für geteilte 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 für geteilte Schaltflächen veranschaulicht.

Dieser Codeabschnitt zeigt die SplitButtonGallery-Befehlsdeklarationen mit einer zugeordneten Group , 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ützte Mindestsystem: Windows 7
Kann leer sein: Nein

Weitere Informationen

Split Button Gallery-Steuerelement
Arbeiten mit Galerien
SetModes
Katalogbeispiel

Freigeben über