<SplitButton> (RibbonDiffXml)

  • Articolo

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

Specifica un controllo utilizzato sia come pulsante sia come menu.

Sintassi

<SplitButton
 Alt="String"
 CacheMenuVersions="true"
 Command="String"
 CommandMenuClose="String"
 CommandMenuOpen="String"
 CommandType="General"
 Id="String"
 Image16by16="String"
 Image16by16Class="String"
 Image16by16Left="Non Positive Integer"
 Image16by16Top="Non Positive Integer"
 Image32by32="String"
 Image32by32Class="String"
 Image32by32Left="Non Positive Integer"
 Image32by32Top="Non Positive Integer"
 LabelText="String"
 MenuAlt="String"
 MenuCommand="String"
 ModernImage=”String”
 PopulateDynamically=["0" | "1" | "true" | "false"]
 PopulateOnlyOnce=["0" | "1" | "true" | "false"]
 PopulateQueryCommand="String"
 Sequence="Integer"
 TemplateAlias="String"
 ToolTipDescription="String"
 ToolTipHelpKeyWord="String"
 ToolTipImage32by32="String"
 ToolTipImage32by32Class="String"
 ToolTipImage32by32Left="Non Postive Integer"
 ToolTipImage32by32Top="Non Postive Integer"
 ToolTipSelectedItemTitle="String"
 ToolTipShortcutKey="String"
 ToolTipTitle="String"
 >
 <Menu />
</SplitButton>

Attributi ed elementi

The following describes 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

CacheMenuVersions

Indica se è necessario memorizzare nella cache la definizione del controllo per migliorare le prestazioni. Selezionare questo valore se non si seleziona PopulateDynamically.

String

Optional

Command

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

String

Optional

CommandMenuClose

Specifica l'ID del comando di menu da eseguire alla chiusura del menu.

String

Optional

CommandMenuOpen

Specifica l'ID del comando della barra multifunzione da eseguire all'apertura del menu.

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

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].[entity].[ribbon].[function].[nome elemento]. Ad esempio: MyISV.account.form.SendToOtherSystem.Button.

Use the {!EntityLogicalName} token in the Id attribute when you are defining a ribbon element that will be used for multiple entities. This will insert 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

Failing to set a globally unique Id value can cause the ribbon not to display.

String

Required

Image16by16

Specifica un'immagine di dimensioni pari a 16x16 pixel. Può trattarsi del percorso di un file di immagine oppure del riferimento a una risorsa Web che utilizza la direttiva $webresource:.

String

Optional

Image16by16Class

Specifica il nome di una classe CSS da utilizzare per l'immagine a 16x16 pixel.

String

Optional

Image16by16Left

Specifica di quanti pixel spostare a sinistra l'immagine a 16x16 pixel. È rappresentato da un numero negativo.

Non positive Integer

Optional

Image16by16Top

Specifica di quanti pixel spostare verso l'alto l'immagine a 16x16 pixel. È rappresentato da un numero negativo.

Non positive Integer

Optional

Image32by32

Specifica un'immagine di dimensioni pari a 32x32 pixel. Può trattarsi del percorso di un file di immagine oppure del riferimento a una risorsa Web che utilizza la direttiva $webresource:.

String

Optional

Image32by32Class

Specifica il nome di una classe CSS da utilizzare per l'immagine a 16x16 pixel.

String

Optional

Image32by32Left

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

Non positive Integer

Optional

Image32by32Top

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

Non positive Integer

Optional

LabelText

Specifica una stringa da visualizzare come testo per il controllo. Può fare riferimento a un elemento LocLabel che utilizza la direttiva $LocLabels:, ad esempio "$LocLabels:MyISV.account.Save.Button.Label".

String

Optional

MenuAlt

Alternative text to represent the menu.

String

Optional

MenuCommand

The name of the command to execute when the menu is clicked.

String

Optional

ModernImage

Solo per uso interno.

String

Optional

PopulateDynamically

Specifica che gli elementi del menu che forniscono opzioni per il controllo verranno popolati in modo dinamico in fase di esecuzione utilizzando il comando definito per l'attributo PopulateQueryCommand.

Boolean

Default = false.

Optional

PopulateOnlyOnce

Quando il controllo viene popolato in modo dinamico, questa impostazione indica che il comando definito dall'attributo PopulateQueryCommand deve essere chiamato una volta sola.

Boolean

Default = false.

Optional

PopulateQueryCommand

Quando il controllo viene popolato in modo dinamico, tramite il comando vengono recuperati gli elementi di menu che forniscono opzioni per il controllo.

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

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

<Menu> (RibbonDiffXml)

Specifica un contenitore utilizzato per mostrare menu a comparsa.

Elementi padre

Element Description

<CommandUIDefinition> (RibbonDiffXml)

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

<Controls> (RibbonDiffXml)

Contiene una raccolta di controlli.

Note

If this element does not have any <Menu> elements and does not have a valid PopulateQueryCommand, the application will throw the following script error at run time: ‘attrs' is null or not an object.

Informazioni elemento

XPath

 
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/SplitButton |
//Controls/SplitButton

Schema Name

SplitButtonType

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 2015 and Microsoft Dynamics CRM Online
Send comments about this topic to Microsoft.
© 2014 Microsoft Corporation. All rights reserved.