<GalleryButton> (RibbonDiffXml)

  • 아티클

적용 대상: CRM 2016 on-prem, CRM Online

더 이상 사용되지 않습니다. 갤러리 요소 내에서 단추 컨트롤을 지정했습니다.

중요

This control was deprecated in Microsoft Dynamics CRM 2011. This control will not render with Microsoft Dynamics CRM Online 2016 Update 및 Microsoft Dynamics CRM 2016(온-프레미스).

구문

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

특성 및 요소

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

특성

Attribute Description Type Usage

Alt

대체 텍스트로 표시할 지역화된 레이블에 대한 참조 또는 문자열입니다.

String

Optional

Command

이 컨트롤에 대한 리본 명령의 ID를 지정합니다.

String

Optional

CommandPreview

컨트롤을 선택하기 전에 컨트롤 위로 커서를 이동할 때 실행할 리본 명령의 ID를 지정합니다.

String

Optional

CommandRevert

사용자가 실행 취소를 선택할 때 실행할 리본 명령의 ID를 지정합니다.

String

Optional

CommandType

다른 유형의 명령을 지정할 수 있습니다.

Valid values:

 

Value Description

General

특정 유형의 명령이 아닙니다.

OptionSelection

사용자가 옵션 그룹에서 한 옵션을 선택할 때 생성되는 명령입니다.

IgnoredByMenu

클릭할 때 메뉴를 닫으면 안 되는 컨트롤에 사용되는 명령입니다.

Enumeration

Optional

CommandValueId

단추를 클릭할 때 명령 이벤트와 함께 전송되는 문자열입니다.

String

Optional

ElementDimensions

갤러리 또는 GalleryButton 요소의 크기를 제어합니다.

Valid values:

  • Size16by16

  • Size32by32

  • Size48by48

  • Size64by48

  • Size72by96

  • Size96by72

  • Size96by96

  • Size128by128

  • Size190by30

  • Size190by40

  • Size190by50

  • Size190by60

Enumeration

Optional

Id

리본 요소의 정의에 대한 고유 식별자를 지정합니다. 적극 권장되는 명명 규칙은 [solution identifier].[entity].[ribbon].[function].[element name]과 같이 마침표를 사용하여 이름의 부분을 분리하는 것입니다. 예를 들면 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.

중요

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

컨트롤에서 메뉴 항목 ID로의 참조를 지정합니다.

String

Optional

QueryCommand

상태 정보를 폴링할 때 실행할 명령의 이름을 지정합니다.

String

Optional

Sequence

기존 리본 요소보다 높거나 낮은 시퀀스 값을 설정하여 리본 수정 위치를 지정합니다.

Integer

Optional

TemplateAlias

CommandUIDefinition의 리본 요소 하위를 레이아웃 요소의 하위 내에 있는 위치 자리 표시자와 연결합니다. 이 값은 레이아웃이 변경될 때 컨트롤 그룹 내에 컨트롤이 표시될 위치를 정의합니다.

String

Optional

ToolTipDescription

컨트롤의 도구 설명에 표시할 문자열을 지정합니다. $LocLabels: 지시문(예: "$LocLabels:MyISV.account.Save.Button.Tooltip")을 사용하여 LocLabel 요소를 참조할 수 있습니다.

String

Optional

ToolTipHelpKeyWord

이 요소는 Microsoft Dynamics CRM에서 사용되지 않습니다.

String

Optional

ToolTipImage32by32

도구 설명과 함께 표시할 32 x 32 픽셀 이미지를 지정합니다.

String

Optional

ToolTipImage32by32Class

도구 설명과 함께 표시할 32 x 32 픽셀 이미지에 적용할 CSS 클래스를 지정합니다.

String

Optional

ToolTipImage32by32Left

도구 설명의 32 x 32 픽셀 이미지를 왼쪽으로 이동할 픽셀 수를 지정합니다. 이 값은 음수로 표시됩니다.

Non positive Integer

Optional

ToolTipImage32by32Top

도구 설명의 32 x 32 픽셀 이미지를 위쪽으로 이동할 픽셀 수를 지정합니다. 이 값은 음수로 표시됩니다.

Non positive Integer

Optional

ToolTipShortcutKey

이 요소는 Microsoft Dynamics CRM에서 사용되지 않습니다.

String

Optional

ToolTipTitle

컨트롤에 대한 도구 설명의 제목에 표시할 문자열을 지정합니다. 이는 일반적으로 컨트롤 LabelText과 동일한 값입니다. $LocLabels: 지시문(예: "$LocLabels:MyISV.account.Save.Button.Label")을 사용하여 LocLabel 요소를 참조할 수 있습니다.

String

Optional

하위 요소

이 요소에는 하위 요소가 없습니다.

상위 요소

Element Description

<Gallery> (RibbonDiffXml)

더 이상 사용되지 않습니다. 리본에서 관련 컨트롤의 모음을 표시하는 컨트롤을 지정했습니다. 갤러리에 항목이 너무 많은 경우 모음의 나머지 항목을 창에 표시하기 위한 확장 화살표가 제공됩니다.

요소 정보

XPath

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

Schema Name

GalleryButtonType

Validation File

RibbonWSS.xsd

Can be Empty

Yes

참고 항목

기타 리소스

Ribbon XML reference
명령 및 리본 사용자 지정

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