Compartilhar via

Elemento MenuGroup

  • Artigo

Representa um contêiner de controles a serem exibidos em uma galeria, menu ou barra de ferramentas.

Uso

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

Atributos

Atributo Tipo Obrigatório Descrição
Classe
 xs:string
 Não
 Especifica o tamanho e o estilo de layout para elementos na interface do usuário do menu.
Um recurso de imagem pode ser fornecido em dois tamanhos (grandes e pequenos) e associado ao elemento na marcação usando os elementos de propriedade Command.LargeImages e Command.SmallImages . Se apenas uma imagem for fornecida, a estrutura a redimensiona conforme necessário.
Restrito a um dos seguintes valores:

(StandardItems)
Padrão.
Estilo: imagem pequena e texto desacentado.
Captura de tela de um botão StandardItems.
(MajorItems)
Estilo: imagem grande e texto em negrito.

Observação:
Se MenuGroup for um filho de ApplicationMenu, o atributo Class será ignorado e um estilo de MajorItems será imposto pela estrutura.


Captura de tela de um botão MajorItems.

CommandName
 xs:positiveInteger ou xs:string
 Não
 Associa o elemento a um Command.

(xs:positiveInteger ou xs:string)
Uma cadeia de caracteres, um valor inteiro entre 2 e 59999, inclusive ou um valor hexadecimal entre 0x2 e 0xea5f, inclusive.
O valor deve ser exclusivo no documento XML da Faixa de Opções.
Comprimento máximo: 100 caracteres.

Elementos filho

Elemento Descrição
Botão
 Pode ocorrer uma ou mais vezes
Checkbox
 Pode ocorrer uma ou mais vezes
ComboBox
 Pode ocorrer uma ou mais vezes
DropDownButton
 Pode ocorrer uma ou mais vezes
DropDownColorPicker
 Pode ocorrer uma ou mais vezes
DropDownGallery
 Pode ocorrer uma ou mais vezes
FontControl
 Pode ocorrer no máximo uma vez
SplitButton
 Pode ocorrer uma ou mais vezes
SplitButtonGallery
 Pode ocorrer uma ou mais vezes
ToggleButton
 Pode ocorrer uma ou mais vezes

Elementos pai

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

Comentários

Obrigatórios.

Deve ocorrer pelo menos uma vez para cada elemento ApplicationMenu, ContextMenu, DropDownButton, DropDownGallery.MenuGroups, InRibbonGallery.MenuGroups, SplitButton.MenuGroups, MiniToolbar ou SplitButtonGallery.MenuGroups .

Se ApplicationMenu for o elemento pai, MenuGroup será restrito aos seguintes elementos filho: Button, DropDownButton, DropDownGallery, SplitButton ou SplitButtonGallery.

Se ContextMenu, DropDownButton, DropDownGallery.MenuGroups, InRibbonGallery.MenuGroups, SplitButton.MenuGroups ou SplitButtonGallery.MenuGroups for o elemento pai, MenuGroup será restrito aos seguintes elementos filho: Button, CheckBox, DropDownButton, DropDownColorPicker, DropDownGallery, SplitButton, SplitButtonGalleryou ToggleButton.

Se MiniToolbar for o elemento pai, MenuGroup será restrito aos seguintes elementos filho: Button, CheckBox, ComboBox, DropDownButton, DropDownColorPicker, DropDownGallery, FontControl, Spinner, SplitButton, SplitButtonGallery ou ToggleButton.

O atributo Class não é necessário quando ApplicationMenu é o elemento pai. A estrutura impõe um valor de MajorItems para o atributo Class.

Quando ApplicationMenu é o elemento pai, o atributo Class não é necessário.

Exemplos

O exemplo a seguir demonstra a marcação básica do SplitButton com um elemento MenuGroup .

Esta seção de código mostra as declarações de Comando SplitButton e MenuGroup com um recurso de imagem grande e pequeno. Um Grupo associado que atua como o contêiner pai para o elemento SplitButton também é declarado.

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

Esta seção de código mostra as declarações de controle SplitButton e MenuGroup com StandardItems e 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>

Informações do elemento

  • Sistema mínimo com suporte: Windows 7
  • Pode estar vazio: Não

Confira também

Especificando recursos de imagem da faixa de opções

Grupo de Menus