다음을 통해 공유

<Button> (RibbonDiffXml)

  • 아티클

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

작업을 수행하는 데 사용되는 간단한 단추를 지정합니다.

구문

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

특성 및 요소

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

특성

Attribute Description Type Usage

Alt

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

String

Optional

Command

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

The command to perform when this button is pressed.

A reference to an existing CommandDefinition.Id value.

String

Optional

CommandType

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

Valid values:

 

Value Description

General

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

OptionSelection

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

IgnoredByMenu

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

Enumeration

Optional

CommandValueId

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

String

Optional

Description

Description 특성은 Microsoft Dynamics CRM에서 사용되지 않습니다.

String

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

Image16by16

16 x 16 픽셀 이미지를 지정합니다. 이미지 파일의 경로이거나 $webresource: 지시문을 사용하여 웹 리소스를 참조할 수 있습니다.

String

Optional

Image16by16Class

16 x 16 픽셀 이미지에 사용할 CSS 클래스의 이름을 지정합니다.

String

Optional

Image16by16Left

16 x 16 픽셀 이미지를 왼쪽으로 이동할 픽셀 수를 지정합니다. 이 값은 음수로 표시됩니다.

Non Positive Integer

Optional

Image16by16Top

16 x 16 픽셀 이미지를 위쪽으로 이동할 픽셀 수를 지정합니다. 이 값은 음수로 표시됩니다.

Non Positive Integer

Optional

Image32by32

32 x 32 픽셀 이미지를 지정합니다. 이미지 파일의 경로이거나 $webresource: 지시문을 사용하여 웹 리소스를 참조할 수 있습니다.

String

Optional

Image32by32Class

16 x 16 픽셀 이미지에 사용할 CSS 클래스의 이름을 지정합니다.

String

Optional

Image32by32Left

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

Non Positive Integer

Optional

Image32by32Top

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

Non Positive Integer

Optional

LabelCss

컨트롤의 레이블에 적용할 CSS 클래스를 지정합니다.

String

Optional

LabelText

컨트롤에 대한 텍스트로 표시할 문자열을 지정합니다. $LocLabels: 지시문(예: "$LocLabels:MyISV.account.Save.Button.Label")을 사용하여 LocLabel 요소를 참조할 수 있습니다.

String

Optional

MenuItemId

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

String

Optional

ModernCommandType

내부 전용입니다.

Valid values:

 

Value Description

ControlCommand

내부 전용입니다.

System

내부 전용입니다.

Enumeration

Optional

ModernImage

내부 전용입니다.

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

<CommandUIDefinition> (RibbonDiffXml)

CustomAction 요소 내에 포함될 시각적 리본 요소를 지정합니다.

<Controls> (RibbonDiffXml)

컨트롤의 모음이 들어 있습니다.

예제

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

요소 정보

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

참고 항목

기타 리소스

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

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