<Controls> (RibbonDiffXml)

Article
01/13/2016

S'applique à: CRM 2016 on-prem, CRM Online

Contient un ensemble de contrôles.

Important

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

Syntaxe

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

Attributs et éléments

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

Attributs

Attribute	Description	Type	Usage
Id	Spécifie un identificateur unique pour la définition d'un élément de ruban. Il est recommandé d'utiliser un point pour séparer les parties du nom, comme suit : [identificateur de solution].[entité].[ruban].[fonction].[nom d'élément]. Par exemple : 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`. Important If you don’t set a globally unique Id value, the ribbon might not display. Important	String	Required
ToolTipDescription	Spécifie une chaîne à afficher pour l'info-bulle d'une commande. Peut référencer un élément LocLabel à l'aide de la directive $LocLabels: (par exemple, « $LocLabels:MyISV.account.Save.Button.Tooltip »).	String	Optional
ToolTipHelpKeyWord	Cet élément n'est pas utilisé dans Microsoft Dynamics CRM.	String	Optional
ToolTipImage32by32	Spécifie une image de 32x32 pixels à afficher avec l'info-bulle.	String	Optional
ToolTipImage32by32Class	Spécifie une classe CSS applicable à l'image de 32x32 pixels à afficher avec l'info-bulle.	String	Optional
ToolTipImage32by32Left	Spécifie le nombre de pixels duquel déplacer l'image d'info-bulle de 32x32 pixels vers la gauche. Cette valeur est représentée par un nombre négatif.	Non Positive Integer	Optional
ToolTipImage32by32Top	Spécifie le nombre de pixels duquel déplacer l'image d'info-bulle de 32x32 pixels vers le haut. Cette valeur est représentée par un nombre négatif.	Non Positive Integer	Optional
ToolTipSelectedItemTitle	Cet élément n'est pas utilisé dans Microsoft Dynamics CRM.	String	Optional
ToolTipShortcutKey	Cet élément n'est pas utilisé dans Microsoft Dynamics CRM.	String	Optional
ToolTipTitle	Spécifie une chaîne à afficher pour le titre d'une info-bulle d'un contrôle. Il s'agit généralement de la même valeur que le LabelText du contrôle. Peut référencer un élément LocLabel à l'aide de la directive $LocLabels: (par exemple, « $LocLabels:MyISV.account.Save.Button.Label »).	String	Optional

Éléments enfants

Element	Description
<Button> (RibbonDiffXml)	Spécifie un bouton simple utilisé pour effectuer une action.
<CheckBox> (RibbonDiffXml)	Spécifie une case à cocher utilisée pour sélectionner une option. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<ColorPicker> (RibbonDiffXml)	Déconseillé : spécifie une grille utilisée pour sélectionner une couleur ou un style. This element is only valid when Controls is a child of <MenuSection> (RibbonDiffXml)
<ComboBox> (RibbonDiffXml)	Déconseillé : spécifie la liste utilisée pour sélectionner une valeur par clic ou saisie. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<DropDown> (RibbonDiffXml)	Déconseillé : spécifie la liste utilisée pour sélectionner une valeur par clic. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<FlyoutAnchor> (RibbonDiffXml)	Spécifie un bouton avec une flèche vers le bas utilisé pour ouvrir un menu.
<GalleryButton> (RibbonDiffXml)	Déconseillé : spécifie un contrôle de bouton dans un élément de galerie. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<InsertTable> (RibbonDiffXml)	Déconseillé : spécifie une grille de 10x10 utilisée pour indiquer les dimensions d'une table. This element is only valid when Controls is a child of <MenuSection> (RibbonDiffXml)
<Label> (RibbonDiffXml)	Spécifie une ligne de texte utilisée pour fournir des informations. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<MRUSplitButton> (RibbonDiffXml)	Déconseillé : spécifie un contrôle de bouton partagé affichant les éléments récemment utilisés. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<Spinner> (RibbonDiffXml)	Spécifie un contrôle utilisé pour insérer une valeur en la tapant ou en utilisant les flèches pour faire défiler les valeurs. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<SplitButton> (RibbonDiffXml)	Spécifie un contrôle utilisé comme bouton et menu. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<TextBox> (RibbonDiffXml)	Déconseillé : spécifie un contrôle utilisé pour entrer du texte. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<ToggleButton> (RibbonDiffXml)	Spécifie un bouton utilisé pour basculer entre les états Activé et Désactivé.

Éléments parents

Element	Description
<Group> (RibbonDiffXml)	Spécifie un groupe de contrôles au sein d'un onglet partageant un modèle de disposition commun.
<CommandUIDefinition> (RibbonDiffXml)	Spécifie les éléments de ruban visibles à inclure dans un élément CustomAction.
<MenuSection> (RibbonDiffXml)	Spécifie une section utilisée pour séparer un menu. Une section de menu peut avoir un titre et contenir des contrôles.

Informations sur l'élément

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

Voir aussi

Autres ressources

Personnaliser les commandes et le ruban
Ribbon XML reference