SplitButton-Element

Stellt ein Standardsteuerelement für die Geteilte Schaltfläche dar.

Verbrauch

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

Attribute

attribute type Erforderlich Beschreibung
ApplicationModes
xs:string
Nein
Gültig nur, wenn MenuGroup das übergeordnete Element ist.

(xs:string)
Eine Zeichenfolge, die eine kommatrennte Liste mit ganzzahligen Zahlen zwischen 0 und 31 enthält.
Leerzeichen sind gültig und 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, inklusive.
Der Wert muss im XML-Dokument des Menübands eindeutig sein.
Maximale Länge: 100 Zeichen.

Untergeordnete Elemente

Element Beschreibung
Schaltfläche
Kann eine oder mehrere Mal auftreten

Checkbox
Kann eine oder mehrere Mal auftreten

DropDownButton
Kann eine oder mehrere Mal auftreten

DropDownColorPicker
Kann eine oder mehrere Mal auftreten

DropDownGallery
Kann eine oder mehrere Mal auftreten

SplitButton
Kann eine oder mehrere Mal auftreten

SplitButton.ButtonItem
Kann am häufigsten einmal auftreten

SplitButton.MenuGroups
Kann am häufigsten einmal auftreten

SplitButtonGallery
Kann eine oder mehrere Mal auftreten

ToggleButton
Kann eine oder mehrere Mal auftreten

Übergeordnete Elemente

Element
ControlGroup
DropDownGallery
Gruppe
Menugroup
SplitButton
SplitButtonGallery

Hinweise

Optional.

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

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

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

SplitButton.MenuGroups müssen einmal auftreten, wenn folgendes nicht als untergeordnete Elemente von SplitButton vorhanden ist:

Diese Steuerelemente werden als untergeordnete Elemente eines einzelnen Standardelements splitButton.MenuGroups behandelt.

Beispiele

Im folgenden Beispiel wird das grundlegende Markup für die Schaltfläche "Teilen" veranschaulicht.

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

<!-- 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"/>

Dieser Codeabschnitt zeigt die SplitButton-Steuerelementdeklarationen .

<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

  • Mindest unterstütztes System: Windows 7
  • Kann leer sein: Nein

Siehe auch

Steuerelement "Geteilte Schaltfläche"

SetModes