Partager via

<Controls> (RibbonDiffXml)

  • Article

S'applique à: CRM 2015 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].[entity].[ribbon].[function].[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

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