Share via

<GalleryButton> (RibbonDiffXml)

  • Artículo

Se aplica a: CRM 2016 on-prem, CRM Online

Obsoleto: Especificaba un control de botón en un elemento de galería.

Importante

This control was deprecated in Microsoft Dynamics CRM 2011. This control will not render with Actualización 2016 de Microsoft Dynamics CRM Online y Microsoft Dynamics CRM 2016 (local).

Sintaxis

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

The following table lists the attributes, child elements, and parent elements.

Atributos

Attribute Description Type Usage

Alt

Cadena o referencia a una etiqueta localizada para mostrar un texto alternativo.

String

Optional

Command

Especifica el identificador del comando de la cinta de opciones de este control.

String

Optional

CommandPreview

Especifica el identificador del comando de la cinta de opciones para ejecutar cuando se pasa el cursor sobre el control antes de que se seleccione.

String

Optional

CommandRevert

Especifica el identificador del comando de la cinta de opciones para que se ejecute cuando el usuario seleccione deshacer.

String

Optional

CommandType

Permite especificar un tipo distinto de comando.

Valid values:

 

Value Description

General

No es un tipo específico de comando.

OptionSelection

Un comando generado cuando un usuario selecciona una opción en un grupo de opciones.

IgnoredByMenu

Un comando usado para controles que no deberían cerrar el menú cuando se hace clic en ellos.

Enumeration

Optional

CommandValueId

Una cadena que se envía con el evento de comando cuando se hace clic en el botón.

String

Optional

ElementDimensions

Controla el tamaño del elemento de galería o de GalleryButton.

Valid values:

  • Size16by16

  • Size32by32

  • Size48by48

  • Size64by48

  • Size72by96

  • Size96by72

  • Size96by96

  • Size128by128

  • Size190by30

  • Size190by40

  • Size190by50

  • Size190by60

Enumeration

Optional

Id

Especifica un identificador único para la definición de un elemento de la cinta de opciones. La convención de nomenclatura más recomendada es la de usar un punto para separar las partes del nombre como: [identificador de solución].[entidad].[cinta de opciones].[función].[nombre de elemento]. Por ejemplo: 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 una referencia de un control al identificador de un elemento de menú.

String

Optional

QueryCommand

Especifica el nombre del comando para ejecutar cuando se realiza un sondeo de la información de estado.

String

Optional

Sequence

Especifique la ubicación de la modificación de la cinta de opciones. Para ello, defina el valor de secuencia más alto o más bajo que los elementos de la cinta de opciones existentes.

Integer

Optional

TemplateAlias

Asocia un elemento secundario de la cinta de opciones de CommandUIDefinition con un marcador de posición en un elemento secundario de diseño. Este valor define si el control se mostrará en un grupo de controles cuando el diseño cambie.

String

Optional

ToolTipDescription

Especifica una cadena para mostrar para la información de un control. Puede hacer referencia a un elemento LocLabel que use la directiva $LocLabels:, por ejemplo, "$LocLabels:MyISV.account.Save.Button.Tooltip".

String

Optional

ToolTipHelpKeyWord

Este elemento no es obligatorio en Microsoft Dynamics CRM.

String

Optional

ToolTipImage32by32

Especifica una imagen de 32 por 32 píxeles para mostrarse con la información.

String

Optional

ToolTipImage32by32Class

Especifica una clase CSS para aplicar a la imagen de 32 por 32 píxeles para mostrarse con la información.

String

Optional

ToolTipImage32by32Left

Especifica el número de píxeles para mover la imagen de 32 por 32 píxeles de información hacia la izquierda. Se representa con un número negativo.

Non positive Integer

Optional

ToolTipImage32by32Top

Especifica el número de píxeles para mover la imagen de 32 por 32 píxeles de información hacia arriba. Se representa con un número negativo.

Non positive Integer

Optional

ToolTipShortcutKey

Este elemento no es obligatorio en Microsoft Dynamics CRM.

String

Optional

ToolTipTitle

Especifica una cadena para mostrar el título de la información de un control. Suele ser el mismo valor que el control LabelText. Puede hacer referencia a un elemento LocLabel que use la directiva $LocLabels:, por ejemplo, "$LocLabels:MyISV.account.Save.Button.Label".

String

Optional

Elementos secundarios

Este elemento no tiene elementos secundarios.

Elementos primarios

Element Description

<Gallery> (RibbonDiffXml)

Obsoleto: Especificaba un control que muestra una recopilación de controles relacionados en la cinta de opciones. Si hay demasiados elementos en la galería, se proporciona una flecha de expansión para mostrar el resto de la recopilación en un panel.

Información del elemento

XPath

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

Schema Name

GalleryButtonType

Validation File

RibbonWSS.xsd

Can be Empty

Yes

Vea también

Otros recursos

Ribbon XML reference
Personalizar los comandos y la cinta de opciones

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