Delen via

<SplitButton> (RibbonDiffXml)

  • Artikel

Van toepassing op: CRM 2015 on-prem, CRM Online

Hiermee wordt een besturingselement voor een knop en een menu opgegeven.

Syntaxis

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

Kenmerken en elementen

The following describes the attributes, child elements, and parent elements.

Kenmerken

Attribute Description Type Usage

Alt

Tekenreeks of verwijzing naar een gelokaliseerd label die als vervangende tekst kan worden weergegeven.

String

Optional

CacheMenuVersions

Geeft aan of de definitie voor het besturingselement in het cachegeheugen moet worden opgeslagen voor betere prestaties. Selecteer deze waarde als u de waarde PopulateDynamically niet selecteert.

String

Optional

Command

Hiermee wordt de id van de lintopdracht voor dit besturingselement opgegeven.

String

Optional

CommandMenuClose

Hiermee wordt de id opgegeven van de menuopdracht die moet worden uitgevoerd wanneer het menu wordt gesloten.

String

Optional

CommandMenuOpen

Hiermee wordt de id opgegeven van de lintopdracht die moet worden uitgevoerd wanneer het menu wordt geopend.

String

Optional

CommandType

Houdt rekening met de eventuele opgave van een ander type opdracht.

Valid values:

 

Value Description

General

Geen specifiek type opdracht.

OptionSelection

Een opdracht die wordt gegenereerd wanneer een gebruiker een optie selecteert in een optiegroep.

IgnoredByMenu

Een opdracht die wordt gebruikt voor besturingselementen die het menu niet moeten sluiten wanneer erop wordt geklikt.

Enumeration

Optional

Id

Hiermee wordt een unieke id voor de definitie van een lintelement opgegeven. De naamconventie die wij sterk aanbevelen is het gebruik van een punt om delen van de naam als volgt te scheiden: [oplossings-id].[entity].[ribbon].[function].[elementnaam]. Bijvoorbeeld: 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

Belangrijk

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

String

Required

Image16by16

Hiermee wordt een afbeelding van 16x16 pixels opgegeven. Dit kan een pad zijn naar een afbeeldingsbestand of het kan verwijzen naar een webresource met de instructie $webresource:.

String

Optional

Image16by16Class

Geeft de naam van een CSS-klasse aan die wordt gebruikt voor de afbeelding van 16x16 pixels.

String

Optional

Image16by16Left

Geeft het aantal pixels aan waarmee de afbeelding van 16x16 pixels naar links wordt verplaatst. Dit wordt weergegeven door een negatief getal.

Non positive Integer

Optional

Image16by16Top

Geeft het aantal pixels aan waarmee de afbeelding van 16x16 pixels naar boven moet worden verplaatst. Dit wordt weergegeven door een negatief getal.

Non positive Integer

Optional

Image32by32

Hiermee wordt een afbeelding van 32x32 pixels opgegeven. Dit kan een pad zijn naar een afbeeldingsbestand of het kan verwijzen naar een webresource met de instructie $webresource:.

String

Optional

Image32by32Class

Geeft de naam van een CSS-klasse aan die wordt gebruikt voor de afbeelding van 16x16 pixels.

String

Optional

Image32by32Left

Geeft het aantal pixels aan waarmee de afbeelding van 32x32 pixels naar links moet worden verplaatst. Dit wordt weergegeven door een negatief getal.

Non positive Integer

Optional

Image32by32Top

Geeft het aantal pixels aan waarmee de afbeelding van 32x32 pixels naar boven moet worden verplaatst. Dit wordt weergegeven door een negatief getal.

Non positive Integer

Optional

LabelText

Hiermee wordt een tekenreeks opgegeven om als tekst voor een besturingselement getoond te worden. Dit kan verwijzen naar een LocLabel-element met de instructie $LocLabels:, bijvoorbeeld, "$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

Alleen voor intern gebruik.

String

Optional

PopulateDynamically

Geeft aan dat de menu-elementen die opties verschaffen voor dit besturingselement dynamisch van gegevens worden voorzien tijdens uitvoeringstijd, met de opdracht die gedefinieerd wordt door het PopulateQueryCommand-kenmerk.

Boolean

Default = false.

Optional

PopulateOnlyOnce

Als het besturingselement dynamisch van gegevens wordt voorzien, geeft deze instelling aan dat de opdracht die door het PopulateQueryCommand-kenmerk is gedefinieerd maar één keer moet worden aangeroepen.

Boolean

Default = false.

Optional

PopulateQueryCommand

Wanneer het besturingselement dynamisch van gegevens wordt voorzien, worden de menu-elementen die opties verschaffen voor dit besturingselement opgehaald door deze opdracht.

String

Optional

Sequence

U kunt de locatie van de lintaanpassing opgeven door de waarde van Volgorde hoger of lager in te stellen dan die van de bestaande lintelementen.

Integer

Optional

TemplateAlias

Koppelt een onderliggend lintelement van de CommandUIDefinition met een tijdelijke locatieaanduiding in een onderliggend element van een indelingselement. Deze waarde geeft aan waar het besturingselement wordt weergegeven binnen een groep besturingselementen wanneer de indeling wordt gewijzigd.

String

Optional

ToolTipDescription

Hiermee wordt een tekenreeks opgegeven om weer te geven in de knopinfo voor een besturingselement. Dit kan verwijzen naar een LocLabel-element met de instructie $LocLabels:, bijvoorbeeld, "$LocLabels:MyISV.account.Save.Button.Tooltip".

String

Optional

ToolTipHelpKeyWord

Dit element wordt niet gebruikt in Microsoft Dynamics CRM.

String

Optional

ToolTipImage32by32

Hiermee wordt een afbeelding van 32x32 pixels opgegeven die moet worden weergegeven bij de knopinfo.

String

Optional

ToolTipImage32by32Class

Geeft een CSS-klasse voor de afbeelding van 32x32 pixels aan die moet worden weergegeven bij de knopinfo.

String

Optional

ToolTipImage32by32Left

Geeft het aantal pixels aan waarmee de knopinfo-afbeelding van 32x32 pixels naar links moet worden verplaatst. Dit wordt weergegeven door een negatief getal.

Non positive Integer

Optional

ToolTipImage32by32Top

Geeft het aantal pixels aan waarmee de knopinfo-afbeelding van 32x32 pixels naar boven moet worden verplaatst. Dit wordt weergegeven door een negatief getal.

Non positive Integer

Optional

ToolTipSelectedItemTitle

Dit element wordt niet gebruikt in Microsoft Dynamics CRM.

String

Optional

ToolTipShortcutKey

Dit element wordt niet gebruikt in Microsoft Dynamics CRM.

String

Optional

ToolTipTitle

Hiermee wordt een tekenreeks opgegeven om weer te geven in de titel van de knopinfo voor een besturingselement. Dit is doorgaans dezelfde waarde als het besturingselement LabelText. Dit kan verwijzen naar een LocLabel-element met de instructie $LocLabels:, bijvoorbeeld, "$LocLabels:MyISV.account.Save.Button.Label".

String

Optional

Onderliggende elementen

Element Description

<Menu> (RibbonDiffXml)

Hiermee wordt een container voor de weergave van pop-upmenu's opgegeven.

Bovenliggende elementen

Element Description

<CommandUIDefinition> (RibbonDiffXml)

Hiermee worden de zichtbare lintelementen opgegeven die in een CustomAction-element worden opgenomen.

<Controls> (RibbonDiffXml)

Bevat een verzameling besturingselementen.

Opmerkingen

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.

Informatie over elementen

XPath

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

Schema Name

SplitButtonType

Validation File

RibbonWSS.xsd

Can be Empty

Yes

Zie ook

Overige resources

Ribbon XML reference
Opdrachten en het lint aanpassen

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