MenuGroup-Element

Stellt einen Container von Steuerelementen dar, die in einem Katalog, Menü oder einer Symbolleiste angezeigt werden.

Verwendung

<MenuGroup
  Class = "xs:string"
  CommandName = "xs:positiveInteger or xs:string">
  child elements
</MenuGroup>

Attributes

attribute type Erforderlich BESCHREIBUNG
Klasse
xs:string
Nein
Gibt die Größe und den Layoutstil für Elemente in der Menübenutzeroberfläche an.
Eine Bildressource kann in zwei Größen (groß und klein) bereitgestellt und dem Element im Markup mithilfe der Eigenschaftenelemente Command.LargeImages und Command.SmallImages zugeordnet werden. Wenn nur ein Image bereitgestellt wird, wird die Größe des Frameworks nach Bedarf geändert.
Auf einen der folgenden Werte beschränkt:

(StandardItems)
Standard.
Stil: kleines Bild und hervorgehobener Text.
Screen shot of a StandardItems button.
(MajorItems)
Stil: großes Bild und fett formatierten Text.
[!Note]
Wenn MenuGroup ein untergeordnetes ApplicationMenu-Attributist, wird das Class-Attribut ignoriert, und ein Stil von MajorItems wird vom Framework erzwungen.

Screen shot of a MajorItems button.
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.

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

FontControl
Kann nur einmal auftreten.

SplitButton
Kann ein oder mehrere Male auftreten.

SplitButtonGallery
Kann ein oder mehrere Male auftreten.

ToggleButton
Kann ein oder mehrere Male auftreten.

Übergeordnete Elemente

Element
ApplicationMenu
ContextMenu
DropDownButton
DropDownGallery.MenuGroups
InRibbonGallery.MenuGroups
MiniToolbar
SplitButton.MenuGroups
SplitButtonGallery.MenuGroups

Bemerkungen

Erforderlich.

Muss mindestens einmal für jedes ApplicationMenu-, ContextMenu-, DropDownButton-, DropDownGallery.MenuGroups-, InRibbonGallery.MenuGroups-, SplitButton.MenuGroups-, MiniToolbar-oder SplitButtonGallery.MenuGroups-Element auftreten.

Wenn ApplicationMenu das übergeordnete Element ist, ist MenuGroup auf die folgenden untergeordneten Elemente beschränkt: Button, DropDownButton, DropDownGallery, SplitButtonoder SplitButtonGallery.

Wenn ContextMenu, DropDownButton, DropDownGallery.MenuGroups, InRibbonGallery.MenuGroups, SplitButton.MenuGroupsoder SplitButtonGallery.MenuGroups das übergeordnete Element ist, ist MenuGroup auf die folgenden untergeordneten Elemente beschränkt: Button, CheckBox, DropDownButton, DropDownColorPicker, DropDownGallery, SplitButton, SplitButtonGalleryoder ToggleButton.

Wenn MiniToolbar das übergeordnete Element ist, ist MenuGroup auf die folgenden untergeordneten Elemente beschränkt: Button, CheckBox, ComboBox, DropDownButton, DropDownColorPicker, DropDownGallery, FontControl, Spinner, SplitButton, SplitButtonGalleryoder ToggleButton.

Das Class-Attribut ist nicht erforderlich, wenn ApplicationMenu das übergeordnete Element ist. Das Framework erzwingt den Wert MajorItems für das Class-Attribut.

Wenn ApplicationMenu das übergeordnete Element ist, ist das Class-Attribut nicht erforderlich.

Beispiele

Im folgenden Beispiel wird das grundlegende Markup für splitButton mit einem MenuGroup-Element veranschaulicht.

Dieser Codeabschnitt zeigt die Befehlsdeklarationen SplitButton und MenuGroup mit einer großen und einer kleinen Bildressource. Eine zugeordnete Gruppe, die als übergeordneter Container für das SplitButton-Element fungiert, wird ebenfalls deklariert.

<!-- 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- und MenuGroup-Steuerelementdeklarationen mit und StandardItems MajorItems .

<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

Angeben von Menübandbildressourcen

Menügruppe