<Button> (RibbonDiffXml)

Gælder for: CRM 2016 on-prem, CRM Online

Angiver en simpel knap, der bruges til at udføre en handling.

Syntaks

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

Attributter og elementer

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

Attributter

Attribute	Description	Type	Usage
Alt	Streng eller henvisning til en oversat etiket, der skal vises som alternativ tekst.	String	Optional
Command	Angiver id'et for kommandoen på båndet for dette kontrolelement. The command to perform when this button is pressed. A reference to an existing CommandDefinition.Id value.	String	Optional
CommandType	Gør det muligt at angive en anden type kommando. Valid values:   Value Description General Ikke en bestemt type kommando. OptionSelection En kommando, der oprettes, når en bruger vælger én indstilling i en grupperet indstilling. IgnoredByMenu En kommando, der bruges til kontrolelementer, som ikke skal lukke menuen, når der klikkes på dem.	Enumeration	Optional
CommandValueId	En streng, der sendes sammen med kommandohændelsen, når der klikkes på knappen.	String	Optional
Description	Beskrivelsesattributten bruges ikke i Microsoft Dynamics CRM.	String	Optional
Id	Angiver et entydigt id for definitionen på et element på båndet. Det anbefales på det kraftigste at bruge navnekonventionen, der adskiller delene i navnet med et punktum som f.eks.: [løsnings-id].[objekt].[bånd].[funktion].[elementnavn]. Et eksempel: 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. Vigtigt! If you don’t set a globally unique Id value, the ribbon might not display.	String	Required
Image16by16	Angiver et billede på 16 x 16 pixel. Det kan være stien til en billedfil, eller det kan henvise til en webressource ved hjælp af $webresource:-direktivet.	String	Optional
Image16by16Class	Angiver navnet på en CSS-klasse, der skal bruges til billedet på 16 x 16 pixel.	String	Optional
Image16by16Left	Angiver det antal pixel, billedet på 16 x 16 pixel skal flyttes til venstre. Dette repræsenteres ved et negativt tal.	Non Positive Integer	Optional
Image16by16Top	Angiver det antal pixel, billedet på 16 x 16 pixel skal flyttes opad. Dette repræsenteres ved et negativt tal.	Non Positive Integer	Optional
Image32by32	Angiver et billede på 32 x 32 pixel. Det kan være stien til en billedfil, eller det kan henvise til en webressource ved hjælp af $webresource:-direktivet.	String	Optional
Image32by32Class	Angiver navnet på en CSS-klasse, der skal bruges til billedet på 16 x 16 pixel.	String	Optional
Image32by32Left	Angiver det antal pixel, billedet på 32 x 32 pixel skal flyttes til venstre. Dette repræsenteres ved et negativt tal.	Non Positive Integer	Optional
Image32by32Top	Angiver det antal pixel, billedet på 32 x 32 pixel skal flyttes opad. Dette repræsenteres ved et negativt tal.	Non Positive Integer	Optional
LabelCss	Angiver en CSS-streng, der skal anvendes på etiketten for objektet.	String	Optional
LabelText	Angiver en streng, der skal vises som tekst for kontrolelementet. Dette kan henvise til et LocLabel-element ved hjælp af $LocLabels:-direktivet, f.eks. "$LocLabels:MyISV.account.Save.Button.Label".	String	Optional
MenuItemId	Angiver en reference fra et kontrolelement til id'et for et menupunkt.	String	Optional
ModernCommandType	Kun til intern brug. Valid values:   Value Description ControlCommand Kun til intern brug. System Kun til intern brug.	Enumeration	Optional
ModernImage	Kun til intern brug.	String	Optional
Sequence	Angiv placeringen af det ændrede bånd ved at angive sekvensværdien til at være højere eller lavere end eksisterende elementer på båndet.	Integer	Optional
TemplateAlias	Knytter et element på båndet, der er underordnet i forhold til CommandUIDefinition, til en placeringspladsholder i et underordnet element i forhold til et layoutelement. Denne værdi definerer, hvor kontrolelementet vises i en gruppe kontrolelementer, når layoutet ændres.	String	Optional
ToolTipDescription	Angiver en streng, der skal vises som værktøjstip for et kontrolelement. Dette kan henvise til et LocLabel-element ved hjælp af $LocLabels:-direktivet, f.eks. "$LocLabels:MyISV.account.Save.Button.Tooltip".	String	Optional
ToolTipHelpKeyWord	Dette element bruges ikke i Microsoft Dynamics CRM.	String	Optional
ToolTipImage32by32	Angiver en billede på 32 x 32 pixel, der skal vises sammen med værktøjstippet.	String	Optional
ToolTipImage32by32Class	Angiver en CSS-klasse, der skal anvendes på det billede på 32 x 32 pixel, som skal vises sammen med værktøjstippet.	String	Optional
ToolTipImage32by32Left	Angiver det antal pixel, billedet af værktøjstippet på 32 x 32 pixel skal flyttes til venstre. Dette repræsenteres ved et negativt tal.	Non Positive Integer	Optional
ToolTipImage32by32Top	Angiver det antal pixel, billedet på 32 x 32 pixel af værktøjstippet skal flyttes opad. Dette repræsenteres ved et negativt tal.	Non Positive Integer	Optional
ToolTipShortcutKey	Dette element bruges ikke i Microsoft Dynamics CRM.	String	Optional
ToolTipTitle	Angiver en streng, der skal vises som titel til et værktøjstip for et kontrolelement. Dette er normalt den samme værdi som kontrolelementets etikettekst. Dette kan henvise til et LocLabel-element ved hjælp af $LocLabels:-direktivet, f.eks. "$LocLabels:MyISV.account.Save.Button.Label".	String	Optional

Underordnede elementer

Dette element har ingen underordnede elementer.

Overordnede elementer

Element	Description
<CommandUIDefinition> (RibbonDiffXml)	Angiver de synlige elementer på båndet, der skal inkluderes i et CustomAction-element.
<Controls> (RibbonDiffXml)	Indeholder en samling objekter.

Eksempel

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

Elementoplysninger

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

Se også

Andre ressourcer

Tilpasse kommandoer og båndet
Ribbon XML reference

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