Compartir a través de

<Button> (RibbonDiffXml)

  • Artículo

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

Especifica un botón simple usado para realizar una acción.

Sintaxis

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

The command to perform when this button is pressed.

A reference to an existing CommandDefinition.Id value.

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

Description

Microsoft Dynamics CRM no utiliza el atributo Descripción.

String

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

Image16by16

Especifica una imagen de 16 por 16 píxeles. Puede ser una ruta a un archivo de imagen o puede hacer referencia a un recurso web mediante la directiva $webresource:.

String

Optional

Image16by16Class

Especifica el nombre de una clase CSS para usar para la imagen de 16 por 16 píxeles.

String

Optional

Image16by16Left

Especifica el número de píxeles para mover la imagen de 16 por 16 píxeles a la izquierda. Se representa con un número negativo.

Non Positive Integer

Optional

Image16by16Top

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

Non Positive Integer

Optional

Image32by32

Especifica una imagen de 32 por 32 píxeles. Puede ser una ruta a un archivo de imagen o puede hacer referencia a un recurso web mediante la directiva $webresource:.

String

Optional

Image32by32Class

Especifica el nombre de una clase CSS para usar para la imagen de 16 por 16 píxeles.

String

Optional

Image32by32Left

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

Non Positive Integer

Optional

Image32by32Top

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

Non Positive Integer

Optional

LabelCss

Especifica una clase CSS para aplicar la etiqueta al control.

String

Optional

LabelText

Especifica una cadena para mostrar como el texto del control. Puede hacer referencia a un elemento LocLabel que use la directiva $LocLabels:, por ejemplo, "$LocLabels:MyISV.account.Save.Button.Label".

String

Optional

MenuItemId

Especifica una referencia de un control al identificador de un elemento de menú.

String

Optional

ModernCommandType

Para uso interno.

Valid values:

 

Value Description

ControlCommand

Para uso interno.

System

Para uso interno.

Enumeration

Optional

ModernImage

Para uso interno.

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

<CommandUIDefinition> (RibbonDiffXml)

Especifica los elementos visibles de la cinta de opciones para incluirse en un elemento CustomAction.

<Controls> (RibbonDiffXml)

Contiene una recopilación de controles.

Ejemplo

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

Información del elemento

XPath

 
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Button |
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Controls/Button |
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Menu/MenuSection/Controls/Button

Schema Name

ButtonType

Validation File

RibbonWSS.xsd

Can be Empty

Yes

Vea también

Otros recursos

Personalizar los comandos y la cinta de opciones
Ribbon XML reference

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