Elemento MenuGroup

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. (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.
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