Del via

<GalleryButton> (RibbonDiffXml)

  • Artikel

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

Udfaset: Angav et knapkontrolelement i et gallerielement.

ImportantVigtigt!
This control was deprecated in Microsoft Dynamics CRM 2011. This control will not render with Opdatering til Microsoft Dynamics CRM Online 2016 og Microsoft Dynamics CRM 2016 (lokalt).

Syntaks

<GalleryButton 
 Alt="String"
 Command="String"
 CommandPreview="String"
 CommandRevert="String"
 CommandType=["General" | "OptionSelection" | "IgnoredByMenu"]
 CommandValueId="String"
 ElementDimensions=
  ["Size16by16" |
  "Size32by32" |
  "Size48by48" |
  "Size64by48" |
  "Size72by96" |
  "Size96by72" |
  "Size96by96" |
  "Size128by128" |
  "Size190by30" |
  "Size190by40" |
  "Size190by50" |
  "Size190by60"]
 Id="String"
 Image="String"
 ImageClass="String"
 ImageLeft="Non Positive Integer"
 ImageTop="Non Positive Integer"
 InnerHTML="String"
 MenuItemId="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"
/>

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.

String

Optional

CommandPreview

Angiver id'et for den kommando på båndet, der skal køres, når markøren holdes over kontrolelementet, før det er valgt.

String

Optional

CommandRevert

Angiver id'et for den kommando på båndet, der skal køres, når brugeren vælger fortryd.

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

ElementDimensions

Styrer størrelsen på i et Gallery- eller GalleryButton-element.

Valid values:

  • Size16by16

  • Size32by32

  • Size48by48

  • Size64by48

  • Size72by96

  • Size96by72

  • Size96by96

  • Size128by128

  • Size190by30

  • Size190by40

  • Size190by50

  • Size190by60

Enumeration

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.

ImportantVigtigt!
If you don’t set a globally unique Id value, the ribbon might not display.

String

Required

Image

A server-relative URL to a file that contains an image to be used as an icon.If an Image attribute is not defined, an InnerHTML attribute must be defined.

String

Optional

ImageClass

The name of a CSS class selector to be applied to the image.

String

Optional

ImageLeft

A negative integer that represents an offset for the left edge of the image. Use this attribute when the Image attribute points to an image file that contains images for several icons.

Non positive Integer

Optional

ImageTop

A negative integer that represents an offset for the top edge of the image. Use this attribute when the Image attribute points to an image file that contains images for several icons.

Non positive Integer

Optional

InnerHTML

HTML markup that illustrates the choice that the button represents.If the InnerHTML attribute is not defined, the Image attribute must be defined.

String

Optional

MenuItemId

Angiver en reference fra et kontrolelement til id'et for et menupunkt.

String

Optional

QueryCommand

Angiver navnet på den kommando, der skal køres, når der forespørges efter tilstandsoplysninger.

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

<Gallery> (RibbonDiffXml)

Udfaset: Angav et kontrolelement, der viser en samling relaterede kontrolelementer på båndet. Hvis der er for mange elementer i galleriet, kan du bruge en udvidelsespil til at få vist resten af samlingen i en rude.

Elementoplysninger

XPath

 
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Gallery/GalleryButton |
//Menu/MenuSection/Gallery/GalleryButton

Schema Name

GalleryButtonType

Validation File

RibbonWSS.xsd

Can be Empty

Yes

Se også

Andre ressourcer

Ribbon XML reference
Tilpasse kommandoer og båndet

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