Delen via

<ToggleButton> (RibbonDiffXml)

  • Artikel

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

Hiermee wordt een knop voor het in- en uitschakelen van een toestand opgegeven.

Syntaxis

<ToggleButton
 Alt="String"
 Command="String"
 CommandValueId="String"
 Description="String"
 Id="String"
 Image16by16="String"
 Image16by16Class="String"
 Image16by16Left="Non Positive Integer"
 Image16by16Top="Non Positive Integer"
 Image32by32="String"
 Image32by32Class="String"
 Image32by32Left="Non Postive Integer"
 Image32by32Top="Non Positive Integer"
 LabelCss="String"
 LabelText="String"
 MenuItemId="String"
 ModernCommandType=["ControlCommand" | "System"]
 ModernImage=”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"
 />

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

Command

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

String

Optional

CommandValueId

Een tekenreeks die samen met de opdrachtgebeurtenis wordt verzonden wanneer op de knop wordt geklikt.

String

Optional

Description

Het kenmerk Beschrijving wordt niet gebruikt in Microsoft Dynamics CRM.

String

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 te scheiden, als volgt: [solution identifier].[entity].[ribbon].[function].[element name]. 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

LabelCss

Hiermee wordt een CSS-klasse opgegeven die op het label voor het besturingselement moet worden toegepast.

String

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

MenuItemId

Hiermee wordt een verwijzing van een besturingselement naar de id van een menu-item opgegeven.

String

Optional

ModernCommandType

Uitsluitend voor intern gebruik.

Valid values:

 

Value Description

ControlCommand

Uitsluitend voor intern gebruik.

System

Uitsluitend voor intern gebruik.

Enumeration

Optional

ModernImage

Uitsluitend voor intern gebruik.

String

Optional

QueryCommand

Hiermee wordt de naam opgegeven van de opdracht die moet worden uitgevoerd wanneer statusinformatie wordt opgevraagd.

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

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

Dit element heeft geen onderliggende elementen.

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.

Informatie over elementen

XPath

 
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/ToggleButton
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Controls/ToggleButton
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Menu/MenuSection/Controls/ToggleButton

Schema Name

ToggleButtonType

Validation File

RibbonWSS.xsd

Can be Empty

Yes

Zie ook

Overige resources

Ribbon XML reference
Opdrachten en het lint aanpassen

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