Elemento SplitButton (Server Ribbon)

Artigo
04/08/2023

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

Define um controle que combina um botão e um menu suspenso.

<SplitButton
  Alt="Text"
  CacheMenuVersions="TRUE | FALSE"
  Command="Text"
  CommandMenuOpen="Text"
  CommandMenuClose="Text"
  CommandType="General | OptionSelection | IgnoredByMenu"
  Id="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"
  LabelText="Text"
  MenuAlt="Text"
  MenuCommand="Text"
  PopulateDynamically=" TRUE | FALSE "
  PopulateQueryCommand="Text"
  PopulateOnlyOnce=" TRUE | FALSE "
  Sequence="Integer"
  TemplateAlias="Text"
  ToolTipImage32by32="Url"
  ToolTipImage32by32Class="CSS Class Selector"
  ToolTipImage32by32Left="Negative Integer"
  ToolTipImage32by32Top="Negative Integer"
  ToolTipTitle="Text"
  ToolTipDescription="Text"
  ToolTipHelpKeyWord="Text"
  ToolTipSelectedItemTitle="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.
CacheMenuVersions	Opcional. TRUE para armazenar versões construídas anteriormente de um menu dinâmico. O padrão é FALSE.
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.
CommandMenuOpen	Opcional. O nome do comando a ser executado quando o menu for aberto.
CommandMenuClose	Opcional. O nome do comando a ser executado quando o menu for fechado.
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.
Id	Obrigatório. Uma cadeia de caracteres que identifica 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.
Labeltext	Opcional. Texto para rotular o controle.
MenuAlt	Opcional. Texto alternativo para representar o menu.
Menucommand	Opcional. O nome do comando a ser executado quando o menu for selecionado.
PopulateDynamically	Opcional. TRUE para criar o menu dinamicamente. O padrão é FALSE.
PopulateQueryCommand	Opcional. O nome do comando a ser executado ao criar um menu dinâmico.
PopulateOnlyOnce	Opcional. TRUE para preencher um menu dinâmico apenas na primeira vez em que ele é acessado.
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 dimensionar e posicionar controles 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 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 aparece no corpo da dica de ferramenta.
ToolTipHelpKeyWord	Opcional. A palavra-chave usada pela Ajuda sensível ao contexto.
ToolTipSelectedItemTitle	Opcional. O título da dica de ferramenta exibida para o item selecionado.
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

Elementos pai

Occurrences

Mínimo: 0
Máximo: desvinculado

Partilhar via