<Controls> (RibbonDiffXml)

Artículo
01/13/2016

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

Contiene una recopilación de controles.

Importante

The valid child elements of the Controls element depend on the parent element.

Sintaxis

  <CommandUIDefinition>
   <Controls
    Id="String"
    ToolTipDescription="String"
    ToolTipHelpKeyWord="String"
    ToolTipImage32by32="String"
    ToolTipImage32by32Class="String"
    ToolTipImage32by32Left="NonPositiveInteger"
    ToolTipImage32by32Top="NonPositiveInteger"
    ToolTipTitle="String">
    [ 
      <Button /> |
      <CheckBox /> |
      <ComboBox /> |
      <ColorPicker /> |
      <ContextualGroup /> |
      <Controls /> |
      <DropDown /> |
      <FlyoutAnchor /> |
      <Gallery /> |
      <GalleryButton /> |
      <GroupTemplate /> |
      <Group /> |
      <Groups /> |
      <InsertTable /> |
      <Label /> |
      <MRUSplitButton /> |
      <MaxSize /> |
      <Menu /> |
      <MenuSection /> |
      <Scale /> |
      <Scaling /> |
      <Spinner /> |
      <SplitButton /> |
      <Tab /> |
      <TextBox/> |
      <ToggleButton />
     ]
   </Controls>
  </CommandUIDefinition>

  <MenuSection>
   <Controls
    Id="String"
    ToolTipDescription="String"
    ToolTipHelpKeyWord="String"
    ToolTipImage32by32="String"
    ToolTipImage32by32Class="String"
    ToolTipImage32by32Left="NonPositiveInteger"
    ToolTipImage32by32Top="NonPositiveInteger"
    ToolTipTitle="String">
    [ 
      <ToggleButton /> |
      <Button /> |
      <ColorPicker /> |
      <FlyoutAnchor /> |
      <InsertTable /> 
     ]
   </Controls>
  </MenuSection>

Atributos y elementos

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

Atributos

Attribute	Description	Type	Usage
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. Importante	String	Required
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
<Button> (RibbonDiffXml)	Especifica un botón simple usado para realizar una acción.
<CheckBox> (RibbonDiffXml)	Especifica una casilla usada para seleccionar una opción. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<ColorPicker> (RibbonDiffXml)	Obsoleto: Especificaba una cuadrícula usada para seleccionar un color o estilo. This element is only valid when Controls is a child of <MenuSection> (RibbonDiffXml)
<ComboBox> (RibbonDiffXml)	Obsoleto: Especificaba una lista usada para seleccionar un valor haciendo clic o escribiendo. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<DropDown> (RibbonDiffXml)	Obsoleto: Especificaba una lista usada para seleccionar un valor haciendo clic. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<FlyoutAnchor> (RibbonDiffXml)	Especifica un botón con una flecha abajo usado para abrir un menú.
<GalleryButton> (RibbonDiffXml)	Obsoleto: Especificaba un control de botón en un elemento de galería. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<InsertTable> (RibbonDiffXml)	Obsoleto: Especificaba una cuadrícula de 10 por 10 usada para especificar las dimensiones de una tabla. This element is only valid when Controls is a child of <MenuSection> (RibbonDiffXml)
<Label> (RibbonDiffXml)	Especifica una línea de texto usada para proporcionar información. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<MRUSplitButton> (RibbonDiffXml)	Obsoleto: Especificaba un control de botón de expansión que muestra los elementos más usados recientemente. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<Spinner> (RibbonDiffXml)	Especifica un control usado para insertar un valor escribiendo o usando las teclas de flecha para pasar por los valores. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<SplitButton> (RibbonDiffXml)	Especifica un control usado como botón y como menú. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<TextBox> (RibbonDiffXml)	Obsoleto: Especificaba un control usado para introducir texto. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<ToggleButton> (RibbonDiffXml)	Especifica un botón usado para cambiar entre estado activado y desactivado.

Elementos primarios

Element	Description
<Group> (RibbonDiffXml)	Especifica un grupo de controles en una pestaña que comparte una plantilla de diseño común.
<CommandUIDefinition> (RibbonDiffXml)	Especifica los elementos visibles de la cinta de opciones para incluirse en un elemento CustomAction.
<MenuSection> (RibbonDiffXml)	Especifica una sección usada para dividir un menú. Una sección de menú puede tener un título y contener controles.

Información del elemento

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

Vea también

Otros recursos

Personalizar los comandos y la cinta de opciones
Ribbon XML reference

Share via