SplitButton-Element

  • Artikel
  • 2 Minuten Lesedauer

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