Compartilhar via

<GalleryButton> (RibbonDiffXml)

  • Artigo

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

Preterido: Especificava um controle de botão em um elemento de galeria.

Importante

This control was deprecated in Microsoft Dynamics CRM 2011. This control will not render with Atualização do Microsoft Dynamics CRM Online 2016 e Microsoft Dynamics CRM 2016 (local).

Sintaxe

<GalleryButton 
 Alt="String"
 Command="String"
 CommandPreview="String"
 CommandRevert="String"
 CommandType=["General" | "OptionSelection" | "IgnoredByMenu"]
 CommandValueId="String"
 ElementDimensions=
  ["Size16by16" |
  "Size32by32" |
  "Size48by48" |
  "Size64by48" |
  "Size72by96" |
  "Size96by72" |
  "Size96by96" |
  "Size128by128" |
  "Size190by30" |
  "Size190by40" |
  "Size190by50" |
  "Size190by60"]
 Id="String"
 Image="String"
 ImageClass="String"
 ImageLeft="Non Positive Integer"
 ImageTop="Non Positive Integer"
 InnerHTML="String"
 MenuItemId="String"
 QueryCommand="String"
 Sequence="Integer"
 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.

String

Optional

CommandPreview

Especifica a ID do comando de faixa de opções a ser executado quando o cursor é colocado sobre o controle antes de ele ser selecionado.

String

Optional

CommandRevert

Especifica a ID do comando de faixa de opções a ser executado quando o usuário seleciona desfazer.

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

CommandValueId

Uma cadeia de caracteres que é enviada ao evento de comando quando o botão é clicado.

String

Optional

ElementDimensions

Controla o tamanho de um elemento Gallery ou GalleryButton.

Valid values:

  • Size16by16

  • Size32by32

  • Size48by48

  • Size64by48

  • Size72by96

  • Size96by72

  • Size96by96

  • Size128by128

  • Size190by30

  • Size190by40

  • Size190by50

  • Size190by60

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 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 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

If you don’t set a globally unique Id value, the ribbon might not display.

String

Required

Image

A server-relative URL to a file that contains an image to be used as an icon.If an Image attribute is not defined, an InnerHTML attribute must be defined.

String

Optional

ImageClass

The name of a CSS class selector to be applied to the image.

String

Optional

ImageLeft

A negative integer that represents an offset for the left edge of the image. Use this attribute when the Image attribute points to an image file that contains images for several icons.

Non positive Integer

Optional

ImageTop

A negative integer that represents an offset for the top edge of the image. Use this attribute when the Image attribute points to an image file that contains images for several icons.

Non positive Integer

Optional

InnerHTML

HTML markup that illustrates the choice that the button represents.If the InnerHTML attribute is not defined, the Image attribute must be defined.

String

Optional

MenuItemId

Especifica uma referência de um controle à ID de um item de menu.

String

Optional

QueryCommand

Especifica o nome do comando a ser executado durante a sondagem das informações de estado.

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

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

Este elemento não tem elementos filho.

Elemento pai

Element Description

<Gallery> (RibbonDiffXml)

Preterido: Especificava um controle que exibe uma coleção de controles relacionados na Faixa de Opções. Se houver muitos itens na galeria, uma seta de expansão será fornecida para exibir o restante da coleção em um painel.

Informações do elemento

XPath

 
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Gallery/GalleryButton |
//Menu/MenuSection/Gallery/GalleryButton

Schema Name

GalleryButtonType

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.