<Button> (RibbonDiffXml)
Aplica-se a: CRM 2015 on-prem, CRM Online
Especifica um botão simples usado para executar uma ação.
Sintaxe
<Button Alt="String"
Command="String"
CommandType=["General" | "OptionSelection" | "IgnoredByMenu" ]
CommandValueId="String"
Description="String"
Id="String"
Image16by16="String"
Image16by16Class="String"
Image16by16Left="Non Positive Integer"
Image16by16Top="Non Positive Integer"
Image32by32="String"
Image32by32Class="String"
Image32by32Left="String"
Image32by32Top="String"
LabelCss="String"
LabelText="String"
MenuItemId="String"
ModernCommandType=[ "ControlCommand"| "System"]
ModernImage=”String”
Sequence="1"
TemplateAlias="String"
ToolTipDescription="String"
ToolTipHelpKeyWord="String"
ToolTipImage32by32="String"
ToolTipImage32by32Class="String"
ToolTipImage32by32Left="Non Positive Integer"
ToolTipImage32by32Top="Non Positive Integer"
ToolTipShortcutKey="String"
ToolTipTitle="String"
/>
Atributos e elementos
The following table lists 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 |
||||||||
Command |
Especifica a ID do comando de Faixa de Opções deste controle. The command to perform when this button is pressed. A reference to an existing CommandDefinition.Id value. |
String |
Optional |
||||||||
CommandType |
Permite especificar outro tipo de comando. Valid values:
|
Enumeration |
Optional |
||||||||
CommandValueId |
Uma cadeia de caracteres que é enviada ao evento de comando quando o botão é clicado. |
String |
Optional |
||||||||
Description |
O atributo Descrição não é usado pelo Microsoft Dynamics CRM. |
String |
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].[entity].[ribbon].[function]...[nome do elemento]. Por exemplo: MyISV.account.form.SendToOtherSystem.Button. Use the {!EntityLogicalName} token in the Id attribute when you define a ribbon element that will be used for multiple entities. This inserts the entity logical name into the Id value to make sure that the Id value is globally unique. For example, if you use Importante If you don’t set a globally unique Id value, the ribbon might not 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 |
||||||||
LabelCss |
Especifica uma classe CSS a ser aplicada ao rótulo do controle. |
String |
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 |
||||||||
MenuItemId |
Especifica uma referência de um controle à ID de um item de menu. |
String |
Optional |
||||||||
ModernCommandType |
Apenas para uso interno. Valid values:
|
Enumeration |
Optional |
||||||||
ModernImage |
Apenas para uso interno. |
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 |
Este 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 |
||||||||
ToolTipShortcutKey |
Este 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
Este elemento não tem elementos filho.
Elemento pai
Element | Description |
---|---|
Especifica os elementos de Faixa de Opções visíveis a serem incluídos no elemento CustomAction. |
|
Contém uma coleção de controles. |
Exemplo
<Button Id="MyISV.account.form.SendToOtherSystem.Button" Command="MyISV.account.form.SendToOtherSystem.Command" LabelText="$LocLabels:MyISV.account.SendToOtherSystem.LabelText" ToolTipTitle="$LocLabels:MyISV.account.SendToOtherSystem.LabelText" ToolTipDescription="$LocLabels:MyISV.account.SendToOtherSystem.ToolTip" TemplateAlias="o2" Image16by16="$webresource:New_TIcon16x16.png" Image32by32="$webresource:New_TIcon32x32.png" />
Informações do elemento
XPath |
|
Schema Name |
ButtonType |
Validation File |
RibbonWSS.xsd |
Can be Empty |
Yes |
Consulte também
Outros recursos
Personalizar os comandos e a faixa de opções
Ribbon XML reference
Microsoft Dynamics CRM 2015 and Microsoft Dynamics CRM Online
Send comments about this topic to Microsoft.
© 2014 Microsoft Corporation. All rights reserved.