Compartilhar via


<SplitButton> (RibbonDiffXml)

Aplica-se a: CRM 2016 on-prem, CRM Online

Especifica um controle usado como um botão e um menu.

Sintaxe

<SplitButton
 Alt="String"
 CacheMenuVersions="true"
 Command="String"
 CommandMenuClose="String"
 CommandMenuOpen="String"
 CommandType="General"
 Id="String"
 Image16by16="String"
 Image16by16Class="String"
 Image16by16Left="Non Positive Integer"
 Image16by16Top="Non Positive Integer"
 Image32by32="String"
 Image32by32Class="String"
 Image32by32Left="Non Positive Integer"
 Image32by32Top="Non Positive Integer"
 LabelText="String"
 MenuAlt="String"
 MenuCommand="String"
 ModernImage=”String”
 PopulateDynamically=["0" | "1" | "true" | "false"]
 PopulateOnlyOnce=["0" | "1" | "true" | "false"]
 PopulateQueryCommand="String"
 Sequence="Integer"
 TemplateAlias="String"
 ToolTipDescription="String"
 ToolTipHelpKeyWord="String"
 ToolTipImage32by32="String"
 ToolTipImage32by32Class="String"
 ToolTipImage32by32Left="Non Postive Integer"
 ToolTipImage32by32Top="Non Postive Integer"
 ToolTipSelectedItemTitle="String"
 ToolTipShortcutKey="String"
 ToolTipTitle="String"
 >
 <Menu />
</SplitButton>

Atributos e elementos

The following describes the attributes, child elements, and parent elements.

Atributos

Attribute Description Type Usage

Alt

Cadeia de caracteres ou referência a um rótulo localizado a ser exibido como texto alternativo.

String

Optional

CacheMenuVersions

Indica se a definição do controle deve ser armazenado em cache para obter um melhor desempenho. Selecione esse valor se você não selecionar PopulateDynamically.

String

Optional

Command

Especifica a ID do comando de Faixa de Opções deste controle.

String

Optional

CommandMenuClose

Especifica a ID do comando de menu a ser executado quando o menu é fechado.

String

Optional

CommandMenuOpen

Especifica a ID do comando de faixa de opções a ser executado quando o menu é aberto.

String

Optional

CommandType

Permite especificar outro tipo de comando.

Valid values:

 

Value Description

General

Não é um tipo de comando específico.

OptionSelection

Um comando gerado quando um usuário seleciona uma opção em um grupo de opções.

IgnoredByMenu

Um comando usado em controles que não devem fechar o menu quando clicado.

Enumeration

Optional

Id

Especifica um identificador exclusivo para a definição de um elemento de Faixa de Opções. A convenção de nomenclatura recomendável é usar um ponto para separar as partes do nome, como: [identificador da solução].[entidade].[faixa de opções].[função].[nome do elemento]. Por exemplo: MyISV.account.form.SendToOtherSystem.Button.

Use the {!EntityLogicalName} token in the Id attribute when you are defining a ribbon element that will be used for multiple entities. This will insert the entity logical name into the Id value to make sure that the Id value is globally unique.

For example, if you use MyISV.{!EntityLogicalName}.form.SendToOtherSystem.Button with the account entity, the Id will be MyISV.account.form.SendToOtherSystem.Button. For the contact entity the Id will be MyISV.contact.form.SendToOtherSystem.Button

Importante

Failing to set a globally unique Id value can cause the ribbon not to display.

String

Required

Image16by16

Especifica uma imagem de 16 x 16 pixels. Esse pode ser o caminho para um arquivo de imagem ou pode referenciar um recurso da Web usando a diretiva $webresource:.

String

Optional

Image16by16Class

Especifica o nome de uma classe CSS a ser usada na imagem de 16 x 16 pixels.

String

Optional

Image16by16Left

Especifica o número de pixels em que a imagem de 16 x 16 pixels será movida para a esquerda. Isso é representado por um número negativo.

Non positive Integer

Optional

Image16by16Top

Especifica o número de pixels em que a imagem de 16 x 16 pixels será movida para a parte superior. Isso é representado por um número negativo.

Non positive Integer

Optional

Image32by32

Especifica uma imagem de 32 x 32 pixels. Esse pode ser o caminho para um arquivo de imagem ou pode referenciar um recurso da Web usando a diretiva $webresource:.

String

Optional

Image32by32Class

Especifica o nome de uma classe CSS a ser usada na imagem de 16 x 16 pixels.

String

Optional

Image32by32Left

Especifica o número de pixels em que a imagem de 32 x 32 pixels será movida para a esquerda. Isso é representado por um número negativo.

Non positive Integer

Optional

Image32by32Top

Especifica o número de pixels em que a imagem de 32 x 32 pixels será movida para a parte superior. Isso é representado por um número negativo.

Non positive Integer

Optional

LabelText

Especifica uma cadeia de caracteres como texto do controle. Isso pode referenciar um elemento LocLabel usando a diretiva $LocLabels:, por exemplo, "$LocLabels:MyISV.account.Save.Button.Label".

String

Optional

MenuAlt

Alternative text to represent the menu.

String

Optional

MenuCommand

The name of the command to execute when the menu is clicked.

String

Optional

ModernImage

Apenas para uso interno.

String

Optional

PopulateDynamically

Especifica que os elementos de menu que fornecem opções para este controle serão preenchidos dinamicamente no tempo de execução usando o comando definido pelo atributo PopulateQueryCommand.

Boolean

Default = false.

Optional

PopulateOnlyOnce

Quando o controle é preenchido dinamicamente, esta configuração indica que o com comando definido pelo atributo PopulateQueryCommand deve ser chamado somente uma vez.

Boolean

Default = false.

Optional

PopulateQueryCommand

Quando o controle é preenchido dinamicamente, este comando recupera os elementos de menu que fornecem opções para este controle.

String

Optional

Sequence

Especifica o local da modificação da Faixa de Opções definindo o valor da Sequência para um número mais alto ou mais baixo que os elementos de Faixa de Opções existentes.

Integer

Optional

TemplateAlias

Associa o filho de um elemento de Faixa de Opções de CommandUIDefinition com um espaço reservado de local no filho de um elemento Layout. Esse valor define onde o controle será exibido em um grupo de controles quando o layout for alterado.

String

Optional

ToolTipDescription

Especifica uma cadeia de caracteres a ser exibida como dica de ferramenta para um controle. Isso pode referenciar um elemento LocLabel usando a diretiva $LocLabels:, por exemplo, "$LocLabels:MyISV.account.Save.Button.Tooltip".

String

Optional

ToolTipHelpKeyWord

Esse elemento não é usado no Microsoft Dynamics CRM.

String

Optional

ToolTipImage32by32

Especifica uma imagem de 32 x 32 pixels a ser exibida com a dica de ferramenta.

String

Optional

ToolTipImage32by32Class

Especifica uma classe CSS a ser aplicada à imagem de 32 x 32 pixels a ser exibida com a dica de ferramenta.

String

Optional

ToolTipImage32by32Left

Especifica o número de pixels em que a imagem de 32 x 32 pixels da dica de ferramenta será movida para a esquerda. Isso é representado por um número negativo.

Non positive Integer

Optional

ToolTipImage32by32Top

Especifica o número de pixels em que a imagem de 32 x 32 pixels da dica de ferramenta será movida para a parte superior. Isso é representado por um número negativo.

Non positive Integer

Optional

ToolTipSelectedItemTitle

Esse elemento não é usado no Microsoft Dynamics CRM.

String

Optional

ToolTipShortcutKey

Esse elemento não é usado no Microsoft Dynamics CRM.

String

Optional

ToolTipTitle

Especifica uma cadeia de caracteres a ser exibida como título de uma dica de ferramenta para um controle. Esse é geralmente o mesmo valor do controle LabelText. Isso pode referenciar um elemento LocLabel usando a diretiva $LocLabels:, por exemplo, "$LocLabels:MyISV.account.Save.Button.Label".

String

Optional

Elementos filho

Element Description

<Menu> (RibbonDiffXml)

Especifica um contêiner usado para mostrar menus pop-up.

Elemento pai

Element Description

<CommandUIDefinition> (RibbonDiffXml)

Especifica os elementos de Faixa de Opções visíveis a serem incluídos no elemento CustomAction.

<Controls> (RibbonDiffXml)

Contém uma coleção de controles.

Comentários

If this element does not have any <Menu> elements and does not have a valid PopulateQueryCommand, the application will throw the following script error at run time: ‘attrs' is null or not an object.

Informações do elemento

XPath

//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/SplitButton |
//Controls/SplitButton

Schema Name

SplitButtonType

Validation File

RibbonWSS.xsd

Can be Empty

Yes

Consulte também

Outros recursos

Ribbon XML reference
Personalizar os comandos e a faixa de opções

Microsoft Dynamics CRM 2016 and Microsoft Dynamics CRM Online
Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.