Elemento MenuGroup

Representa un contenedor de controles que se van a mostrar en una galería, un menú o una barra de herramientas.

Uso

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

Atributos

Atributo	Tipo	Obligatorio	Descripción
Clase	xs:string	No	Especifica el tamaño y el estilo de diseño de los elementos de la interfaz de usuario del menú. Se puede proporcionar un recurso de imagen en dos tamaños (grandes y pequeños) y asociados con el elemento en el marcado mediante los elementos de propiedad Command.LargeImages y Command.SmallImages . Si solo se proporciona una imagen, el marco lo cambia según sea necesario. Restringido a uno de los siguientes valores: (StandardItems) Predeterminada. Estilo: imagen pequeña y texto desmarcado. (MajorItems) Estilo: imagen grande y texto en negrita. Nota: Si MenuGroup es un elemento secundario de ApplicationMenu, el atributo Class se omite y el marco aplica un estilo de MajorItems .
CommandName	xs:positiveInteger o xs:string	No	Asocia el elemento a un objeto Command. (xs:positiveInteger o xs:string) Una cadena, un valor entero entre 2 y 59999, inclusive o un valor hexadecimal entre 0x2 y 0xea5f, ambos incluidos. El valor debe ser único dentro del documento XML de la cinta de opciones. Longitud máxima: 100 caracteres.

Elementos secundarios

Elemento	Descripción
Botón	Puede producirse una o varias veces
Casilla	Puede producirse una o varias veces
ComboBox	Puede producirse una o varias veces
DropDownButton	Puede producirse una o varias veces
DropDownColorPicker	Puede producirse una o varias veces
DropDownGallery	Puede producirse una o varias veces
FontControl	Puede producirse como máximo una vez
SplitButton	Puede producirse una o varias veces
SplitButtonGallery	Puede producirse una o varias veces
ToggleButton	Puede producirse una o varias veces

Elementos primarios

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

Comentarios

Necesario.

Debe producirse al menos una vez para cada elemento ApplicationMenu, ContextMenu, DropDownButton, DropDownGallery.MenuGroups, InRibbonGallery.MenuGroups, SplitButton.MenuGroups, MiniToolbar o SplitButtonGallery.MenuGroups .

Si ApplicationMenu es el elemento primario, MenuGroup está restringido a los siguientes elementos secundarios: Button, DropDownButton, DropDownGallery, SplitButton o SplitButtonGallery.

Si ContextMenu, DropDownButton, DropDownGallery.MenuGroups, InRibbonGallery.MenuGroups, SplitButton.MenuGroups o SplitButtonGallery.MenuGroups es el elemento primario, MenuGroup se restringe a los siguientes elementos secundarios: Button, CheckBox, DropDownButton, DropDownColorPicker, DropDownGallery, SplitButton, SplitButtonGallery, o ToggleButton.

Si MiniToolbar es el elemento primario, MenuGroup está restringido a los siguientes elementos secundarios: Button, CheckBox, ComboBox, DropDownButton, DropDownColorPicker, DropDownGallery, FontControl, Spinner, SplitButton, SplitButtonGallery o ToggleButton.

El atributo Class no es necesario cuando ApplicationMenu es el elemento primario. El marco aplica un valor de MajorItems para el atributo Class.

Cuando ApplicationMenu es el elemento primario, no se requiere el atributo Class.

Ejemplos

En el ejemplo siguiente se muestra el marcado básico para splitButton con un elemento MenuGroup .

En esta sección de código se muestran las declaraciones de comandos SplitButton y MenuGroup con un recurso de imagen grande y pequeño. También se declara un grupo asociado que actúa como contenedor primario para el elemento SplitButton .

<!-- 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"/>

En esta sección de código se muestran las declaraciones de control SplitButton y MenuGroup con StandardItems y 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>

Información de elemento

• Sistema mínimo admitido: Windows 7
• Puede estar vacío: No

Consulte también

Especificación de recursos de imagen de cinta

Grupo de menús