Share via

<GalleryButton> (RibbonDiffXml)

  • Articolo

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

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

Importante

This control was deprecated in Microsoft Dynamics CRM 2011. This control will not render with Aggiornamento di Microsoft Dynamics CRM Online 2016 e Microsoft Dynamics CRM 2016 (locale).

Sintassi

<GalleryButton 
 Alt="String"
 Command="String"
 CommandPreview="String"
 CommandRevert="String"
 CommandType=["General" | "OptionSelection" | "IgnoredByMenu"]
 CommandValueId="String"
 ElementDimensions=
  ["Size16by16" |
  "Size32by32" |
  "Size48by48" |
  "Size64by48" |
  "Size72by96" |
  "Size96by72" |
  "Size96by96" |
  "Size128by128" |
  "Size190by30" |
  "Size190by40" |
  "Size190by50" |
  "Size190by60"]
 Id="String"
 Image="String"
 ImageClass="String"
 ImageLeft="Non Positive Integer"
 ImageTop="Non Positive Integer"
 InnerHTML="String"
 MenuItemId="String"
 QueryCommand="String"
 Sequence="Integer"
 TemplateAlias="String"
 ToolTipDescription="String"
 ToolTipHelpKeyWord="String"
 ToolTipImage32by32="String"
 ToolTipImage32by32Class="String"
 ToolTipImage32by32Left="Non Positive Integer"
 ToolTipImage32by32Top="Non Positive Integer"
 ToolTipShortcutKey="String"
 ToolTipTitle="String"
/>

Attributi ed elementi

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

Attributi

Attribute Description Type Usage

Alt

Stringa o riferimento a un'etichetta localizzata da visualizzare come testo alternativo.

String

Optional

Command

Specifica l'ID del comando della barra multifunzione per il controllo.

String

Optional

CommandPreview

Specifica l'ID del comando della barra multifunzione da eseguire quando il cursore viene passato sul controllo prima della selezione.

String

Optional

CommandRevert

Specifica l'ID del comando della barra multifunzione da eseguire quando l'utente seleziona undo.

String

Optional

CommandType

Consente di specificare un tipo diverso di comando.

Valid values:

 

Value Description

General

Non un tipo specifico di comando.

OptionSelection

Comando generato quando un utente seleziona un'opzione in un gruppo di opzioni.

IgnoredByMenu

Comando utilizzato per i controlli che non devono venire chiusi quando si fa clic sul menu.

Enumeration

Optional

CommandValueId

Stringa inviata con l'evento di comando quando si fa clic sul pulsante.

String

Optional

ElementDimensions

Controlla la dimensione di un elemento Gallery o GalleryButton.

Valid values:

  • Size16by16

  • Size32by32

  • Size48by48

  • Size64by48

  • Size72by96

  • Size96by72

  • Size96by96

  • Size128by128

  • Size190by30

  • Size190by40

  • Size190by50

  • Size190by60

Enumeration

Optional

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.

String

Required

Image

A server-relative URL to a file that contains an image to be used as an icon.If an Image attribute is not defined, an InnerHTML attribute must be defined.

String

Optional

ImageClass

The name of a CSS class selector to be applied to the image.

String

Optional

ImageLeft

A negative integer that represents an offset for the left edge of the image. Use this attribute when the Image attribute points to an image file that contains images for several icons.

Non positive Integer

Optional

ImageTop

A negative integer that represents an offset for the top edge of the image. Use this attribute when the Image attribute points to an image file that contains images for several icons.

Non positive Integer

Optional

InnerHTML

HTML markup that illustrates the choice that the button represents.If the InnerHTML attribute is not defined, the Image attribute must be defined.

String

Optional

MenuItemId

Specifica un riferimento da un controllo all'ID di una voce di menu.

String

Optional

QueryCommand

Specifica il nome del comando da eseguire al polling delle informazioni sullo stato.

String

Optional

Sequence

Specificare la posizione della modifica della barra multifunzione impostando il parametro Sequence su un valore più alto o più basso degli elementi esistenti della barra multifunzione.

Integer

Optional

TemplateAlias

Associa un elemento della barra multifunzione figlio di CommandUIDefinition a un segnaposto di posizione all'interno di un elemento figlio di un elemento Layout. Questo valore definisce la posizione in cui verrà visualizzato il controllo all'interno di un gruppo di controlli quando viene modificato il layout.

String

Optional

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

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

Questo elemento non presenta elementi figlio.

Elementi padre

Element Description

<Gallery> (RibbonDiffXml)

Deprecato: viene specificato un controllo che visualizza una raccolta di controlli correlati nella barra multifunzione. Se nella raccolta sono presenti troppi elementi, viene fornita una freccia per espandere la visualizzazione e mostrare il resto della raccolta in un riquadro.

Informazioni elemento

XPath

 
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Gallery/GalleryButton |
//Menu/MenuSection/Gallery/GalleryButton

Schema Name

GalleryButtonType

Validation File

RibbonWSS.xsd

Can be Empty

Yes

Vedere anche

Altre risorse

Ribbon XML reference
Personalizzare i comandi e la barra multifunzione

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