다음을 통해 공유


<CheckBox> (RibbonDiffXml)

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

옵션을 선택하는 데 사용되는 확인란을 지정합니다.

구문

<CheckBox
 Alt="String"
 Command="String"
 Id="String"
 LabelText="String"
 MenuItemId="String"
 QueryCommand="String"
 Sequence="integer"
 TemplateAlias="String"
 ToolTipDescription="String"
 ToolTipHelpKeyWord="String"
 ToolTipImage32by32="String"
 ToolTipImage32by32Class="String"
 ToolTipImage32by32Left="NonPositiveInteger"
 ToolTipImage32by32Top="NonPositiveInteger"
 ToolTipShortcutKey="String"
 ToolTipTitle="String" />

특성 및 요소

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

특성

Attribute Description Type Usage

Alt

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

String

Optional

Command

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

A reference to an existing CommandDefinition.Id value.

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.

> [!IMPORTANT] > If you don’t set a globally unique Id value, the ribbon might not display. >

String

Required

LabelText

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

String

Optional

MenuItemId

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

String

Optional

QueryCommand

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

String

Optional

Sequence

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

Integer

Optional

TemplateAlias

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

> [!NOTE] > This element cannot be associated with a template alias that represents an <OverflowSection> (RibbonDiffXml) or a <ControlRef> (RibbonDiffXml) element that uses the Large display mode. >

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

하위 요소

This element has no child elements.

상위 요소

Element Description

<CommandUIDefinition> (RibbonDiffXml)

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

<Controls> (RibbonDiffXml)

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

예제

<CheckBox Command="MyISV.account.form.SendToOtherSystem.Command" Id="MyISV.account.form.SendToOtherSystem.Button" LabelText="$LocLabels:MyISV.account.SendToOtherSystem.LabelText" TemplateAlias="o2" ToolTipDescription="$LocLabels:MyISV.account.SendToOtherSystem.ToolTip" ToolTipTitle="$LocLabels:MyISV.account.SendToOtherSystem.LabelText" />

요소 정보

XPath

//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/CheckBox |
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Controls/CheckBox

Schema Name

CheckBoxType

Validation File

RibbonWSS.xsd

Can be Empty

Yes

참고 항목

기타 리소스

명령 및 리본 사용자 지정
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.