Share via


<CheckBox> (RibbonDiffXml)

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

Especifica una casilla usada para seleccionar una opción.

Sintaxis

<CheckBox
 Alt="String"
 Command="String"
 Id="String"
 LabelText="String"
 MenuItemId="String"
 QueryCommand="String"
 Sequence="integer"
 TemplateAlias="String"
 ToolTipDescription="String"
 ToolTipHelpKeyWord="String"
 ToolTipImage32by32="String"
 ToolTipImage32by32Class="String"
 ToolTipImage32by32Left="NonPositiveInteger"
 ToolTipImage32by32Top="NonPositiveInteger"
 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.

A reference to an existing CommandDefinition.Id value.

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

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

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.

Nota

This element cannot be associated with a template alias that represents an <OverflowSection> (RibbonDiffXml) or a <ControlRef> (RibbonDiffXml) element that uses the Large display mode.

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

This element has no child elements.

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

<CheckBox Command="MyISV.account.form.SendToOtherSystem.Command" Id="MyISV.account.form.SendToOtherSystem.Button" LabelText="$LocLabels:MyISV.account.SendToOtherSystem.LabelText" TemplateAlias="o2" ToolTipDescription="$LocLabels:MyISV.account.SendToOtherSystem.ToolTip" ToolTipTitle="$LocLabels:MyISV.account.SendToOtherSystem.LabelText" />

Información del elemento

XPath

//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/CheckBox |
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Controls/CheckBox

Schema Name

CheckBoxType

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.