Elemento group (Server Ribbon)

Artigo
04/08/2023

Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | | do SharePoint Online SharePoint Server 2013

Define um grupo de controles.

<Group
  Command="Text"
  Description="Text"
  Id="Text"
  Image32by32Popup="Url"
  Image32by32PopupClass="CSS Class Selector"
  Image32by32PopupLeft="Negative Integer"
  Image32by32PopupTop="Negative Integer"
  Sequence="Integer"
  Template="Text"
  Title="Text"
/>

Elementos e atributos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Atributo	Descrição
Comando	Opcional. O valor é usado para habilitar ou desabilitar os controles no grupo. Se o atributo Command estiver presente e tiver um valor, a faixa de opções será votada para ver se o comando está desabilitado. Se ele estiver desabilitado, a faixa de opções não sondará os comandos associados aos controles do grupo; os controles também são efetivamente desabilitados.
Descrição	Opcional. Uma descrição do grupo.
Id	Obrigatório. Uma cadeia de caracteres que identifica o grupo, como "Ribbon.DocLibListForm.Edit.Clipboard".
Image32by32Popup	Opcional. Uma URL relativa ao servidor a um arquivo que contém uma imagem de 32 por 32 pixels a ser usada para representar o grupo, como "/_layouts/1033/images/formatmap32x32.png".
Image32by32PopupClass	Opcional. O nome de um seletor de classe CSS a ser aplicado à imagem.
Image32by32PopupLeft	Opcional. Um inteiro negativo que representa um deslocamento para a borda esquerda da imagem. Use esse atributo quando o atributo Image32by32Popup apontar para um arquivo de imagem que contém imagens para muitos ícones. O valor do atributo Image32by32PopupLeft é usado para definir o atributo esquerdo CSS para o estilo embutido de uma marca img HTML.
Image32by32PopupTop	Opcional. Um inteiro negativo que representa um deslocamento para a borda superior da imagem. Use esse atributo quando o atributo Image32by32Popup apontar para um arquivo de imagem que contém imagens para muitos ícones. O valor do atributo Image32by32PopupTop é usado para definir o atributo superior do CSS para o estilo embutido de uma marca img HTML.
Sequence	Opcional. Um inteiro que especifica a ordem de posicionamento entre nós XML irmãos.
Modelo	Opcional. Uma cadeia de caracteres que corresponde ao atributo Id de um elemento GroupTemplate .
Título	Opcional. O texto exibido como o título do grupo na faixa de opções e na dica de ferramenta.

Elementos filho

Controls

Elementos pai

Occurrences

Mínimo: 0
Máximo: desvinculado

Exemplo

O fragmento XML a seguir define um grupo que contém dois botões.

<Group
  Id="Ribbon.WikiPageTab.CustomGroup"
  Sequence="55"
  Description="Custom Group"
  Title="Custom"
  Command="EnableCustomGroup"
  Template="Ribbon.Templates.Flexible2">
  <Controls Id="Ribbon.WikiPageTab.CustomGroup.Controls">
    <Button
      Id="Ribbon.WikiPageTab.CustomGroup.CustomGroupHello"
      Command="CustomGroupHelloWorld"
      Image16by16="/_layouts/images/FILMSTRP.GIF"
      Image32by32="/_layouts/images/PPEOPLE.GIF"
      LabelText="Hello, World"
      TemplateAlias="o2"
      Sequence="15" />
    <Button
      Id="Ribbon.WikiPageTab.CustomGroup.CustomGroupGoodbye"
      Command="CustomGroupGoodbyeWorld"
      Image16by16="/_layouts/images/FILMSTRP.GIF"
      Image32by32="/_layouts/images/PPEOPLE.GIF"
      LabelText="Good-bye, World"
      TemplateAlias="o2"
      Sequence="18" />
  </Controls>
</Group>

Confira também

Passo a passo: adicionando um grupo à faixa de opções do servidor

Partilhar via