SplitButton-Element

Stellt ein Standardmäßiges Split Button-Steuerelement dar.

Verwendung

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

Attributes

attribute type Erforderlich BESCHREIBUNG
ApplicationModes
xs:string
Nein
Nur gültig, wenn MenuGroup das übergeordnete Element ist.

(xs:string)
Eine Zeichenfolge, die eine durch Komma 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 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 Menüband-XML-Dokuments 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 nur einmal auftreten.

SplitButton.MenuGroups
Kann nur 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 ein oder mehrere Male für jedes ControlGroup-, DropDownGallery-, Group-, MenuGroup-, SplitButton- oder SplitButtonGallery-Element 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 Nachfolger von ApplicationMenu ist.

SplitButton.MenuGroups muss einmal auftreten, wenn folgende Elemente nicht als untergeordnete Elemente von SplitButton vorhanden sind:

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

Beispiele

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

In diesem Codeabschnitt werden die Deklarationen des SplitButton-Befehls mit einer zugeordneten Gruppe gezeigt, 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 gezeigt.

<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ütztes Mindestsystem: Windows 7
  • Kann leer sein: Nein

Weitere Informationen

Steuerelement "Schaltfläche teilen"

SetModes