Compartir a través de


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.
Captura de pantalla de un botón StandardItems.
(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 .


Captura de pantalla de un botón 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