Delen via

<Button> (RibbonDiffXml)

  • Artikel

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

Hiermee wordt een eenvoudige knop voor het uitvoeren van een actie opgegeven.

Syntaxis

<Button Alt="String"
  Command="String"
  CommandType=["General" | "OptionSelection" | "IgnoredByMenu" ]
  CommandValueId="String"
  Description="String"
  Id="String"
  Image16by16="String"
  Image16by16Class="String"
  Image16by16Left="Non Positive Integer"
  Image16by16Top="Non Positive Integer"
  Image32by32="String"
  Image32by32Class="String"
  Image32by32Left="String"
  Image32by32Top="String"
  LabelCss="String"
  LabelText="String"
  MenuItemId="String"
  ModernCommandType=[ "ControlCommand"| "System"]
  ModernImage=”String”
  Sequence="1"
  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 table lists 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.

The command to perform when this button is pressed.

A reference to an existing CommandDefinition.Id value.

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

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

Belangrijk

If you don’t set a globally unique Id value, the ribbon might not 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

Alleen voor intern gebruik.

Valid values:

 

Value Description

ControlCommand

Alleen voor intern gebruik.

System

Alleen voor intern gebruik.

Enumeration

Optional

ModernImage

Alleen voor intern gebruik.

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.

Voorbeeld

<Button Id="MyISV.account.form.SendToOtherSystem.Button"        Command="MyISV.account.form.SendToOtherSystem.Command"        LabelText="$LocLabels:MyISV.account.SendToOtherSystem.LabelText"        ToolTipTitle="$LocLabels:MyISV.account.SendToOtherSystem.LabelText"        ToolTipDescription="$LocLabels:MyISV.account.SendToOtherSystem.ToolTip"        TemplateAlias="o2"        Image16by16="$webresource:New_TIcon16x16.png"        Image32by32="$webresource:New_TIcon32x32.png" />

Informatie over elementen

XPath

 
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Button |
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Controls/Button |
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Menu/MenuSection/Controls/Button

Schema Name

ButtonType

Validation File

RibbonWSS.xsd

Can be Empty

Yes

Zie ook

Overige resources

Opdrachten en het lint aanpassen
Ribbon XML reference

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