MenuGroup-Element

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

Verwendung

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

Attribute

attribute type Erforderlich BESCHREIBUNG
Klasse
xs:string
Nein
Gibt die Größe und das Layoutformat 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 mit den Eigenschaftselementen Command.LargeImages und Command.SmallImages zugeordnet werden. Wenn nur ein Bild bereitgestellt wird, ändert das Framework die Größe wie erforderlich.
Auf einen der folgenden Werte beschränkt:

(StandardItems)
Standard.
Formatvorlage: kleines Bild und hervorgehobener Text.
Screen shot of a StandardItems button.
(MajorItems)
Formatvorlage: großes Bild und fett formatierter Text.
[! Hinweis]
Wenn MenuGroup ein untergeordnetes Element von ApplicationMenu ist, wird das Class-Attribut ignoriert, und eine Formatvorlage 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, 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

Combobox
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

FontControl
Kann am häufigsten einmal auftreten

SplitButton
Kann eine oder mehrere Mal auftreten

SplitButtonGallery
Kann eine oder mehrere Mal auftreten

ToggleButton
Kann eine oder mehrere Mal auftreten

Übergeordnete Elemente

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

Hinweise

Erforderlich.

Muss mindestens einmal für jede 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, SplitButton oder SplitButtonGallery.

Wenn ContextMenu, DropDownButton, DropDownGallery.MenuGroups, InRibbonGallery.MenuGroups, SplitButton.MenuGroups oder SplitButtonGallery.MenuGroups das übergeordnete Element ist, ist menuGroup auf die folgenden untergeordneten Elemente beschränkt: Schaltfläche, CheckBox, DropDownColorPicker, DropDownColorPicker, DropDownGallery, SplitButton, SplitButtonGallery , oder UmggleButton.

Wenn MiniToolbar das übergeordnete Element ist, ist MenuGroup auf die folgenden untergeordneten Elemente beschränkt: Schaltfläche, CheckBox, ComboBox, DropDownColorPicker, DropDownColorPicker, DropDownGallery, FontControl, Spinner, SplitButton, SplitButtonGallery oder ToggleButton.

Das Class-Attribut ist nicht erforderlich, wenn ApplicationMenu das übergeordnete Element ist. Das Framework erzwingt einen Wert von 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 das SplitButton-Element mit einem MenuGroup-Element veranschaulicht.

Dieser Codeabschnitt zeigt die SplitButton - und MenuGroup-Befehlsdeklarationen 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 beiden StandardItems und 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

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

Siehe auch

Angeben von Menübandbildressourcen

Menügruppe