<Controls> (RibbonDiffXml)

  • Articolo

Si applica a: CRM 2016 on-prem, CRM Online

Contiene una raccolta di controlli.

Importante

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

Sintassi

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

Attributi ed elementi

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

Attributi

Attribute Description Type Usage

Id

Specifica un identificatore univoco per la definizione di un elemento della barra multifunzione. La convenzione di denominazione consigliata è l'utilizzo di un punto per separare le parti del nome, come segue: [identificatore soluzione].[entità].[barra multifunzione].[funzione].[nome elemento]. Ad esempio: 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

Specifica una stringa da visualizzare per la descrizione comando di un controllo. Può fare riferimento a un elemento LocLabel che utilizza la direttiva $LocLabels:, ad esempio "$LocLabels:MyISV.account.Save.Button.Tooltip".

String

Optional

ToolTipHelpKeyWord

Questo elemento non è utilizzato in Microsoft Dynamics CRM.

String

Optional

ToolTipImage32by32

Specifica un'immagine a 32x32 pixel da visualizzare con la descrizione comando.

String

Optional

ToolTipImage32by32Class

Specifica una classe CSS da applicare all'immagine a 32x32 pixel da visualizzare con la descrizione comando.

String

Optional

ToolTipImage32by32Left

Specifica di quanti pixel spostare verso sinistra l'immagine a 32x32 pixel della descrizione comando. È rappresentato da un numero negativo.

Non Positive Integer

Optional

ToolTipImage32by32Top

Specifica di quanti pixel spostare verso l'alto l'immagine a 32x32 pixel della descrizione comando. È rappresentato da un numero negativo.

Non Positive Integer

Optional

ToolTipSelectedItemTitle

Questo elemento non è utilizzato in Microsoft Dynamics CRM.

String

Optional

ToolTipShortcutKey

Questo elemento non è utilizzato in Microsoft Dynamics CRM.

String

Optional

ToolTipTitle

Specifica una stringa da visualizzare per il titolo di una descrizione comando di un controllo. Corrisponde in genere allo stesso valore del controllo LabelText. Può fare riferimento a un elemento LocLabel che utilizza la direttiva $LocLabels:, ad esempio "$LocLabels:MyISV.account.Save.Button.Label".

String

Optional

Elementi figlio

Element Description

<Button> (RibbonDiffXml)

Specifica un semplice pulsante utilizzato per eseguire un'azione.

<CheckBox> (RibbonDiffXml)

Specifica una casella di controllo utilizzata per selezionare un'opzione.

This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).

<ColorPicker> (RibbonDiffXml)

Deprecato: viene specificata una griglia utilizzata per selezionare un colore o uno stile.

This element is only valid when Controls is a child of <MenuSection> (RibbonDiffXml)

<ComboBox> (RibbonDiffXml)

Deprecato: viene specificato un elenco utilizzato per selezionare un valore facendo clic su di esso o digitandolo.

This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).

<DropDown> (RibbonDiffXml)

Deprecato: viene specificato un elenco utilizzato per selezionare un valore facendo clic su di esso.

This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).

<FlyoutAnchor> (RibbonDiffXml)

Specifica un pulsante con una freccia GIÙ per aprire un menu.

<GalleryButton> (RibbonDiffXml)

Deprecato: viene specificato un controllo pulsante all'interno di un elemento della raccolta.

This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).

<InsertTable> (RibbonDiffXml)

Deprecato: viene specificata una griglia 10x10 utilizzata per specificare le dimensioni di una tabella.

This element is only valid when Controls is a child of <MenuSection> (RibbonDiffXml)

<Label> (RibbonDiffXml)

Specifica una riga di testo utilizzata per fornire informazioni.

This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).

<MRUSplitButton> (RibbonDiffXml)

Deprecato: viene specificato un controllo pulsante di menu che visualizza gli elementi utilizzati di recente.

This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).

<Spinner> (RibbonDiffXml)

Specifica un controllo utilizzato per inserire un valore digitandolo o utilizzando i tasti di direzione per scorrere i valori.

This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).

<SplitButton> (RibbonDiffXml)

Specifica un controllo utilizzato sia come pulsante sia come menu.

This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).

<TextBox> (RibbonDiffXml)

Deprecato: viene specificato un controllo utilizzato per immettere testo.

This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).

<ToggleButton> (RibbonDiffXml)

Specifica un pulsante utilizzato per alternare lo stato di attivazione e lo stato di disattivazione.

Elementi padre

Element Description

<Group> (RibbonDiffXml)

Specifica un gruppo di controlli all'interno di una scheda che condividono un modello di layout comune.

<CommandUIDefinition> (RibbonDiffXml)

Specifica gli elementi della barra multifunzione visibili da includere in un elemento CustomAction.

<MenuSection> (RibbonDiffXml)

Specifica una sezione utilizzata per dividere un menu. Una sezione di menu può avere un titolo e contenere controlli.

Informazioni 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

Vedere anche

Altre risorse

Personalizzare i comandi e la barra multifunzione
Ribbon XML reference

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