<SplitButton> (RibbonDiffXml)

Artículo
01/13/2016

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

Especifica un control usado como botón y como menú.

Sintaxis

<SplitButton
 Alt="String"
 CacheMenuVersions="true"
 Command="String"
 CommandMenuClose="String"
 CommandMenuOpen="String"
 CommandType="General"
 Id="String"
 Image16by16="String"
 Image16by16Class="String"
 Image16by16Left="Non Positive Integer"
 Image16by16Top="Non Positive Integer"
 Image32by32="String"
 Image32by32Class="String"
 Image32by32Left="Non Positive Integer"
 Image32by32Top="Non Positive Integer"
 LabelText="String"
 MenuAlt="String"
 MenuCommand="String"
 ModernImage=”String”
 PopulateDynamically=["0" | "1" | "true" | "false"]
 PopulateOnlyOnce=["0" | "1" | "true" | "false"]
 PopulateQueryCommand="String"
 Sequence="Integer"
 TemplateAlias="String"
 ToolTipDescription="String"
 ToolTipHelpKeyWord="String"
 ToolTipImage32by32="String"
 ToolTipImage32by32Class="String"
 ToolTipImage32by32Left="Non Postive Integer"
 ToolTipImage32by32Top="Non Postive Integer"
 ToolTipSelectedItemTitle="String"
 ToolTipShortcutKey="String"
 ToolTipTitle="String"
 >
 <Menu />
</SplitButton>

Atributos y elementos

The following describes 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

CacheMenuVersions

Indica si la definición del control debe almacenarse en caché para un mejor rendimiento. Seleccione este valor si no selecciona PopulateDynamically.

String

Optional

Command

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

String

Optional

CommandMenuClose

Especifica el identificador del comando de menú para ejecutar cuando se cierra el menú.

String

Optional

CommandMenuOpen

Especifica el identificador del comando de la cinta de opciones para ejecutar cuando se abre el menú.

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

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 are defining a ribbon element that will be used for multiple entities. This will insert 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

Failing to set a globally unique Id value can cause the ribbon not to 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

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

MenuAlt

Alternative text to represent the menu.

String

Optional

MenuCommand

The name of the command to execute when the menu is clicked.

String

Optional

ModernImage

Para uso interno.

String

Optional

PopulateDynamically

Especifica que los elementos de menú que proporcionan opciones para este control se rellenarán de forma dinámica en tiempo de ejecución mediante el comando definido por el atributo PopulateQueryCommand.

Boolean

Default = false.

Optional

PopulateOnlyOnce

Cuando el control se rellena de forma dinámica, esta configuración indica que el comando definido por el atributo PopulateQueryCommand solo debe llamarse una vez.

Boolean

Default = false.

Optional

PopulateQueryCommand

Cuando el control se rellena de forma dinámica, este comando recupera los elementos de menú que proporcionan opciones para este control.

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

ToolTipSelectedItemTitle

Este elemento no es obligatorio en Microsoft Dynamics CRM.

String

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

Element	Description
<Menu> (RibbonDiffXml)	Especifica un contenedor usado para mostrar menús emergentes.

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.

Comentarios

If this element does not have any <Menu> elements and does not have a valid PopulateQueryCommand, the application will throw the following script error at run time: ‘attrs' is null or not an object.

Información del elemento

XPath	`//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/SplitButton \| //Controls/SplitButton`
Schema Name	SplitButtonType
Validation File	RibbonWSS.xsd
Can be Empty	Yes

Vea también

Otros recursos

Ribbon XML reference
Personalizar los comandos y la cinta de opciones

Compartir a través de

<SplitButton> (RibbonDiffXml)

Sintaxis

Atributos y elementos

Atributos

Elementos secundarios

Elementos primarios

Comentarios

Información del elemento

Vea también

Otros recursos

Recursos adicionales