MenuGroup-Element

Artikel
09/03/2023

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

Verbrauch

<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 den Layoutstil für Elemente in der Menüoberfläche an. Eine Bildressource kann in zwei Größen (groß und klein) bereitgestellt und dem Element im Markup mit den Eigenschaftenelementen Command.LargeImages und Command.SmallImages zugeordnet werden. Wenn nur ein Image bereitgestellt wird, ändert das Framework die Größe nach Bedarf. Beschränkt auf einen der folgenden Werte: (StandardItems) Standard. Stil: kleines Bild und hervorgehobener Text. (MajorItems) Format: großes Bild und fett formatierter Text. Hinweis: Wenn MenuGroup ein untergeordnetes Element von ApplicationMenu ist, wird das Class-Attribut ignoriert, und eine Formatvorlage von `MajorItems` wird vom Framework erzwungen.
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 XML-Dokuments des Menübands 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 höchstens 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

Hinweise

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, 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: Button, CheckBox, DropDownButton, DropDownColorPicker, DropDownGallery, SplitButtonGallery, SplitButtonGallery, oder 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, 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 splitButton mit einem MenuGroup-Element veranschaulicht.

In diesem Codeabschnitt werden die Befehlsdeklarationen SplitButton und MenuGroup mit einer großen und einer kleinen Bildressource angezeigt. 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"/>

In diesem Codeabschnitt werden die SplitButton- und MenuGroup-Steuerelementdeklarationen mit und MajorItemsgezeigtStandardItems.

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

Weitere Informationen

Angeben von Menübandbildressourcen
Menügruppe

Freigeben über