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. 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. 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] Beschränkt auf einen der folgenden Werte (0 und 1 sind ungültig): |
| Itemheight |
xs:integer |
No |
|
| ItemWidth |
xs:integer |
No |
|
| TextPosition |
TextPositionType |
No |
Beschränkt auf einen der folgenden Werte: |
| Typ |
xs:string |
No |
Beschränkt auf einen der folgenden Werte: |
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] |
| 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.

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