Elemento ToggleButton (Server Ribbon)

Artigo
04/08/2023

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

Define um botão que é usado para alternar estados.

<ToggleButton
  Alt="Text"
  Command="Text "
  CommandValueId="Text"
  Description="Text"
  Id="Text"
  LabelCss="CSS Class Selector"
  LabelText="Text"
  Image32by32="Url"
  Image32by32Class="CSS Class Selector"
  Image32by32Left="Negative Integer"
  Image32by32Top="Negative Integer"
  Image16by16="Url"
  Image16by16Class="CSS Class Selector"
  Image16by16Left="Negative Integer"
  Image16by16Top="Negative Integer"
  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.
CommandValueId	Opcional. Uma cadeia de caracteres enviada com o evento de comando quando o botão é selecionado.
Descrição	Opcional. Uma cadeia de caracteres que descreve o botão.
Id	Obrigatório. Uma cadeia de caracteres que identifica o controle, como "Ribbon.Library.ViewFormat.Standard".
LabelCss	Opcional. O nome de um seletor de classe CSS a ser aplicado ao rótulo do controle.
Labeltext	Opcional. Texto para rotular o controle.
Image32by32	Opcional. Uma URL relativa ao servidor a um arquivo que contém uma imagem de 32 por 32 pixels a ser usada como um ícone, como "/_layouts/1033/images/formatmap32x32.png".
Image32by32Class	Opcional. O nome de um seletor de classe CSS a ser aplicado à imagem.
Image32by32Left	Opcional. Um inteiro negativo que representa um deslocamento para a borda esquerda da imagem. Use esse atributo quando o atributo Image32by32 apontar para um arquivo de imagem que contém imagens para muitos ícones. O valor do atributo Image32by32Left é usado para definir o atributo esquerdo CSS para o estilo embutido de uma marca img HTML. Por exemplo, definir o atributo Image32by32Left como " -160" e o atributo Image32by32Top como " -448" resulta em um estilo embutido semelhante ao da seguinte marcação HTML: `HTML<img src="/_layouts/1033/images/formatmap32x32.png" style="position: absolute;left: -160px;top: -448px;" />`
Image32by32Top	Opcional. Um inteiro negativo que representa um deslocamento para a borda superior da imagem. Use esse atributo quando o atributo Image32by32 apontar para um arquivo de imagem que contém as imagens para muitos ícones. O valor do atributo Image32by32Top é usado para definir o atributo superior do CSS para o estilo embutido de uma marca img HTML.
Imagem16by16	Opcional. Uma URL relativa ao servidor a um arquivo que contém uma imagem de 16 por 16 pixels a ser usada como um ícone, como "/_layouts/1033/images/formatmap16x16.png".
Image16by16Class	Opcional. O nome de um seletor de classe CSS a ser aplicado à imagem.
Image16by16Left	Opcional. Um inteiro negativo que representa um deslocamento para a borda esquerda da imagem. Use esse atributo quando o atributo Image16by16 apontar para um arquivo de imagem que contém imagens para muitos ícones. O valor do atributo Image16by16Left é usado para definir o atributo esquerdo CSS para o estilo embutido de uma marca img HTML.
Image16by16Top	Opcional. Um inteiro negativo que representa um deslocamento para a borda superior da imagem. Use esse atributo quando o atributo Image16by16 apontar para um arquivo de imagem que contém imagens para muitos ícones. O valor do atributo Image16by16Top é usado para definir o atributo superior do CSS para o estilo embutido de uma marca img HTML.
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 de classe 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 imagens para muitos ícones. O valor do atributo ToolTipImage32by32Left é usado para definir o atributo esquerdo CSS para o estilo embutido de uma marca img HTML 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 para o estilo embutido de uma marca Img HTML quando a página é criada.
Tooltiptitle	Opcional. O texto que aparece como o título da dica de ferramenta.
ToolTipDescription	Opcional. O texto que é exibido 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 exibe 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

Partilhar via