Freigeben über

SplitButton-Element

Stellt ein Standardsteuerelement für geteilte Schaltflächen dar .

Verbrauch

<SplitButton
  ApplicationModes = "xs:string"
  CommandName = "xs:positiveInteger or xs:string">
  child elements
</SplitButton>

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 mit 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 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.

Untergeordnete Elemente

Element BESCHREIBUNG
Schaltfläche
 Kann ein oder mehrere Male auftreten
CheckBox
 Kann ein oder mehrere Male auftreten
DropDownButton
 Kann ein oder mehrere Male auftreten
DropDownColorPicker
 Kann ein oder mehrere Male auftreten
DropDownGallery
 Kann ein oder mehrere Male auftreten
SplitButton
 Kann ein oder mehrere Male auftreten
SplitButton.ButtonItem
 Kann höchstens einmal auftreten
SplitButton.MenuGroups
 Kann höchstens einmal auftreten
SplitButtonGallery
 Kann ein oder mehrere Male auftreten
ToggleButton
 Kann ein oder mehrere Male auftreten

Übergeordnete Elemente

Element
ControlGroup
DropDownGallery
Gruppe
Menugroup
SplitButton
SplitButtonGallery

Bemerkungen

Optional.

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

SplitButton unterstützt Anwendungsmodi , wenn es in der linken Spalte des Anwendungsmenüs gehostet wird.

DropDownGallery und SplitButtonGallery sind keine gültigen untergeordneten Elemente von DropDownButton , wenn DropDownButton ein Nachkomme von ApplicationMenu ist.

SplitButton.MenuGroups muss einmal auftreten, wenn Folgendes nicht als untergeordnete Elemente von SplitButton vorhanden ist:

Diese Steuerelemente werden als untergeordnete Elemente eines einzelnen SplitButton.MenuGroups-Elements behandelt.

Beispiele

Im folgenden Beispiel wird das grundlegende Markup für die Split Button veranschaulicht.

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

<!-- SplitButton -->
<Command Name="cmdSplitButtonGroup"
         Symbol="cmdSplitButtonGroup"
         Comment="SplitButton Group"
         LabelTitle="SplitButton"/>
<Command Name="cmdSplitButton"
         Symbol="cmdSplitButton"
         Comment="SplitButton"
         LabelTitle="SplitButton"/>
<Command Name="cmdSBButtonItem"
         Symbol="cmdSBButtonItem"
         Comment="SBButtonItem"
         LabelTitle="SB ButtonItem"/>
<Command Name="cmdSBButton1"
         Symbol="cmdSBButton1"
         Comment="SBButton1"
         LabelTitle="SB Button">
  <Command.LargeImages>
    <Image Source="res/copyL_32.bmp"/>
  </Command.LargeImages>
  <Command.SmallImages>
    <Image Source="res/copyS_16.bmp"/>
  </Command.SmallImages>
  <Command.LargeHighContrastImages>
    <Image Source="res/copyLHC_32.bmp"/>
  </Command.LargeHighContrastImages>
  <Command.SmallHighContrastImages>
    <Image Source="res/copySHC_16.bmp"/>
  </Command.SmallHighContrastImages>
</Command>
<Command Name="cmdSBMajorItems"
         Comment="Major Items Category"
         LabelTitle="Major Items"/>
<Command Name="cmdSBStandardItems"
         Comment="Standard Items Category"
         LabelTitle="Standard Items"/>

In diesem Codeabschnitt werden die SplitButton-Steuerelementdeklarationen angezeigt.

<Group CommandName="cmdSplitButtonGroup">
  <SplitButton CommandName="cmdSplitButton">
    <SplitButton.ButtonItem>
      <Button CommandName="cmdSBButtonItem"/>
    </SplitButton.ButtonItem>
    <SplitButton.MenuGroups>
      <MenuGroup CommandName="cmdSBMajorItems" 
                 Class="MajorItems">
        <Button CommandName="cmdSBButton1"/>
        <Button CommandName="cmdSBButton1"/>
      </MenuGroup>
      <MenuGroup CommandName="cmdSBStandardItems"
                 Class="StandardItems">
        <Button CommandName="cmdSBButton1"/>
        <Button CommandName="cmdSBButton1"/>
      </MenuGroup>
      <MenuGroup Class="StandardItems">
        <Button CommandName="cmdSBButton1"/>
        <Button CommandName="cmdSBButton1"/>
      </MenuGroup>
    </SplitButton.MenuGroups>
  </SplitButton>
</Group>

Elementinformationen

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

Siehe auch

Steuerelement "Split Button"

SetModes