Elemento GalleryButton (Grupo) (Faixa de Opções do Servidor)

Artigo
04/08/2023

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

Define um botão galeria.

<GalleryButton
  Alt="Text"
  Command="Text"
  CommandPreview="Text"
  CommandRevert="Text"
  CommandType="General | OptionSelect | IgnoredByMenu"
  CommandValueId="Text"
  ElementDimensions="Size16by16 | Size32by32 | Size48by48 | Size72by96 | Size96by72 | Size96by96 | Size128by128 | Size190by30 | Size190by40 | Size190by50 | Size190by60"
  Id="Text"
  Image="Url"
  ImageClass="CSS Selector"
  ImageLeft="Negative Integer"
  ImageTop="Negative Integer"
  InnerHTML="HTML"
  MenuItemId="Text"
  QueryCommand="Text"
  Sequence="Integer"
  TemplateAlias="Text"
  ToolTipImage32by32="Url"
  ToolTipImage32by32Class="CSS Selector"
  ToolTipImage32by32Left="Negative Integer"
  ToolTipImage32by32Top="Negative Integer"
  ToolTipTitle="Text"
  ToolTipDescription="Text"
  ToolTipHelpKeyWord="Text"
  ToolTipShortcutKey="Text"
/>

Elementos e atributos

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

Atributos

Atributo	Descrição
Alt	Opcional. Texto alternativo que é usado para o controle.
Comando	Opcional. O nome do comando a ser executado quando o controle for selecionado. Se o controle estiver em um elemento CommandUIDefinition , o valor do atributo Command do controle deverá ser o mesmo que o valor do atributo Command de um elemento CommandUIHandler correspondente.
CommandPreview	Opcional. O nome do comando a ser executado para visualizar uma seleção.
CommandRevert	Opcional. O nome do comando a ser executado para retornar ao estado que existia antes de visualizar uma seleção.
CommandType	Opcional. Um valor de enumeração que especifica o tipo de comando. Geral. Não é um tipo específico de comando. OptionSelection. Um comando gerado quando um usuário seleciona uma opção em um grupo de opções. IgnoredByMenu. Um comando que é usado para controles que não devem fechar o menu quando eles são selecionados.
CommandValueId	Opcional. Uma cadeia de caracteres enviada com o evento de comando quando o botão é selecionado.
ElementDimensions	Obrigatório. Um valor de enumeração que especifica as dimensões do retângulo em que o botão é renderizado. As dimensões estão em pixels e estão no formato "largura por altura". Tamanho16by16 Tamanho32by32 Tamanho48by48 Tamanho72by96 Size96by72 Size96by96 Tamanho128by128 Tamanho190by30 Tamanho190by40 Tamanho190by50 Tamanho190by60
Id	Obrigatório. Uma cadeia de caracteres que identifica o elemento, como "buttonStaticStyle1".
Imagem	Opcional. Uma URL relativa ao servidor a um arquivo que contém uma imagem a ser usada como um ícone. Se um atributo Image não for definido, um atributo InnerHTML deverá ser definido.
Imageclass	Opcional. O nome de um seletor de classe CSS a ser aplicado à imagem.
ImageLeft	Opcional. Um inteiro negativo que representa um deslocamento para a borda esquerda da imagem. Use esse atributo quando o atributo Image apontar para um arquivo de imagem que contém imagens para vários ícones.
ImageTop	Opcional. Um inteiro negativo que representa um deslocamento para a borda superior da imagem. Use esse atributo quando o atributo Image apontar para um arquivo de imagem que contém imagens para vários ícones.
Innerhtml	Opcional. Marcação HTML que ilustra a escolha que o botão representa. Se o atributo InnerHTML não estiver definido, o atributo Image deverá ser definido.
MenuItemId	Opcional. Uma cadeia de caracteres que identifica o item de menu em que o botão está localizado.
QueryCommand	Opcional. O nome do comando a ser executado ao sondar informações de estado.
Sequence	Opcional. Um inteiro que especifica a ordem de posicionamento entre nós XML irmãos.
TemplateAlias	Opcional. Uma cadeia de caracteres que corresponde ao valor do atributo TemplateAlias para um elemento ControlRef , um elemento OverflowArea ou um elemento OverflowSection em um elemento GroupTemplate . O atributo TemplateAlias é usado para controles de tamanho e posição em um grupo quando um modelo é aplicado ao grupo.
ToolTipImage32by32	Opcional. Uma URL relativa ao servidor a um arquivo que contém uma imagem de 32 por 32 pixels a ser usada na dica de ferramenta, como "/_layouts/1033/images/formatmap32x32.png".
ToolTipImage32by32Class	Opcional. O nome de um seletor CSS a ser aplicado à imagem da dica de ferramenta.
ToolTipImage32by32Left	Opcional. Um inteiro negativo que representa um deslocamento para a borda esquerda da imagem. Use esse atributo quando o atributo ToolTipImage32by32 apontar para um arquivo de imagem que contém as imagens para muitos ícones. O valor do atributo ToolTipImage32by32Left é usado para definir o atributo esquerdo CSS quando a página é criada.
ToolTipImage32by32Top	Opcional. Um inteiro negativo que representa um deslocamento para a borda superior da imagem. Use esse atributo quando o atributo ToolTipImage32by32 apontar para um arquivo de imagem que contém as imagens para muitos ícones. O valor do atributo ToolTipImage32by32Top é usado para definir o atributo superior do CSS quando a página é criada.
Tooltiptitle	Opcional. O texto que aparece como o título da dica de ferramenta.
ToolTipDescription	Opcional. O texto que aparece no corpo da dica de ferramenta.
ToolTipHelpKeyWord	Opcional. A palavra-chave usada pela Ajuda sensível ao contexto.
ToolTipShortcutKey	Opcional. O texto a ser exibido para a chave de atalho na dica de ferramenta. Por exemplo, se a chave de atalho para o controle for Alt+J, o valor desse atributo será "Alt+J". A dica de ferramenta exibirá o texto da chave de atalho em parênteses após o título da dica de ferramenta: "(Alt+J)".

Elementos filho

Nenhum

Elementos pai

CommandUIDefinition
Controles (Grupo)

Occurrences

Mínimo: 0
Máximo: desvinculado

Exemplo

O exemplo a seguir é um fragmento XML que define um grupo de controles de botão de galeria que são usados para aplicar um estilo de formatação.

<Group
    Id="grpStyles"
    Description=""
    Title="Group Styles"
    Template="tmpStyles">
    <Controls>
        <GalleryButton
            Id="buttonStaticStyle1"
            Command="ApplyStyle"
            QueryCommand="QueryStyle"
            InnerHTML="&amp;lt;DIV class=&amp;quot;PreviewStyleContainer&amp;quot;&amp;gt;&amp;lt;P class=&amp;quot;PreviewStaticStyle1&amp;quot; id=&amp;quot;labelPreviewContent0&amp;quot;&amp;gt;&amp;lt;/P&amp;gt;&amp;lt;P class=&amp;quot;PreviewStyleLabel&amp;quot; id=&amp;quot;labelPreviewStyle0&amp;quot;&amp;gt;&amp;lt;/P&amp;gt;&amp;lt;/DIV&amp;gt;"
            ElementDimensions="Size64by48"
            LabelText="Heading1"
            Alt="Heading1"
            TemplateAlias="preview1"/>
        <GalleryButton
            Id="buttonStaticStyle2"
            Command="ApplyStyle"
            QueryCommand="QueryStyle"
            InnerHTML="&amp;lt;DIV class=&amp;quot;PreviewStyleContainer&amp;quot;&amp;gt;&amp;lt;P class=&amp;quot;PreviewStaticStyle2&amp;quot; id=&amp;quot;labelPreviewContent1&amp;quot;&amp;gt;&amp;lt;/P&amp;gt;&amp;lt;P class=&amp;quot;PreviewStyleLabel&amp;quot; id=&amp;quot;labelPreviewStyle1&amp;quot;&amp;gt;&amp;lt;/P&amp;gt;&amp;lt;/DIV&amp;gt;"
            ElementDimensions="Size64by48"
            LabelText="Heading2"
            Alt="Heading2"
            TemplateAlias="preview2"/>
        <GalleryButton
            Id="buttonStaticStyle3"
            QueryCommand="QueryStyle"
            Command="ApplyStyle"
            InnerHTML="&amp;lt;DIV class=&amp;quot;PreviewStyleContainer&amp;quot;&amp;gt;&amp;lt;P class=&amp;quot;PreviewStaticStyle3&amp;quot; id=&amp;quot;labelPreviewContent2&amp;quot;&amp;gt;&amp;lt;/P&amp;gt;&amp;lt;P class=&amp;quot;PreviewStyleLabel&amp;quot; id=&amp;quot;labelPreviewStyle2&amp;quot;&amp;gt;&amp;lt;/P&amp;gt;&amp;lt;/DIV&amp;gt;"
            ElementDimensions="Size64by48"
            LabelText="Heading3"
            Alt="Heading3"
            TemplateAlias="preview3"/>
        <GalleryButton
            Id="buttonStaticStyle4"
            Command="ApplyStyle"
            QueryCommand="QueryStyle"
            InnerHTML="&amp;lt;DIV class=&amp;quot;PreviewStyleContainer&amp;quot;&amp;gt;&amp;lt;P class=&amp;quot;PreviewStaticStyle4&amp;quot; id=&amp;quot;labelPreviewContent3&amp;quot;&amp;gt;&amp;lt;/P&amp;gt;&amp;lt;P class=&amp;quot;PreviewStyleLabel&amp;quot; id=&amp;quot;labelPreviewStyle3&amp;quot;&amp;gt;&amp;lt;/P&amp;gt;&amp;lt;/DIV&amp;gt;"
            ElementDimensions="Size64by48"
            LabelText="Quote"
            Alt="Quote"
            TemplateAlias="preview4"/>
        <GalleryButton
            Id="buttonStaticStyle5"
            Command="ApplyStyle"
            QueryCommand="QueryStyle"
            InnerHTML="&amp;lt;DIV class=&amp;quot;PreviewStyleContainer&amp;quot;&amp;gt;&amp;lt;P class=&amp;quot;PreviewStaticStyle5&amp;quot; id=&amp;quot;labelPreviewContent4&amp;quot;&amp;gt;&amp;lt;/P&amp;gt;&amp;lt;P class=&amp;quot;PreviewStyleLabel&amp;quot; id=&amp;quot;labelPreviewStyle4&amp;quot;&amp;gt;&amp;lt;/P&amp;gt;&amp;lt;/DIV&amp;gt;"
            ElementDimensions="Size64by48"
            LabelText="Citation"
            Alt="Citation"
            TemplateAlias="preview5"/>
        <FlyoutAnchor
            Alt="STR@L_MenuMoreStyles"
            Id="fsfaMoreStyles"
            Command="MenuOpenEditOnly"
            MenuAlt="STR@L_MenuMoreStyles"
            LabelText="STR@L_MenuMoreStyles"
            Image32by32="IMGMAP@one@UxGalWordQuickFormatsHH"
            TemplateAlias="morestyles"
            PopulateDynamically="true"
            PopulateOnlyOnce="false"
            PopulateQueryCommand="PopulateMenuMoreStyles"
            CommandMenuClose="MenuClose"
            CacheMenuVersions="false">
        </FlyoutAnchor>
    </Controls>
</Group>

Partilhar via