<SplitButton> (RibbonDiffXml)

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

단추와 메뉴로 모두 사용되는 컨트롤을 지정합니다.

구문

<SplitButton
 Alt="String"
 CacheMenuVersions="true"
 Command="String"
 CommandMenuClose="String"
 CommandMenuOpen="String"
 CommandType="General"
 Id="String"
 Image16by16="String"
 Image16by16Class="String"
 Image16by16Left="Non Positive Integer"
 Image16by16Top="Non Positive Integer"
 Image32by32="String"
 Image32by32Class="String"
 Image32by32Left="Non Positive Integer"
 Image32by32Top="Non Positive Integer"
 LabelText="String"
 MenuAlt="String"
 MenuCommand="String"
 ModernImage=”String”
 PopulateDynamically=["0" | "1" | "true" | "false"]
 PopulateOnlyOnce=["0" | "1" | "true" | "false"]
 PopulateQueryCommand="String"
 Sequence="Integer"
 TemplateAlias="String"
 ToolTipDescription="String"
 ToolTipHelpKeyWord="String"
 ToolTipImage32by32="String"
 ToolTipImage32by32Class="String"
 ToolTipImage32by32Left="Non Postive Integer"
 ToolTipImage32by32Top="Non Postive Integer"
 ToolTipSelectedItemTitle="String"
 ToolTipShortcutKey="String"
 ToolTipTitle="String"
 >
 <Menu />
</SplitButton>

특성 및 요소

The following describes the attributes, child elements, and parent elements.

특성

Attribute	Description	Type	Usage
Alt	대체 텍스트로 표시할 지역화된 레이블에 대한 참조 또는 문자열입니다.	String	Optional
CacheMenuVersions	성능 향상을 위해 컨트롤에 대한 정의가 캐시되는지 여부를 나타냅니다. PopulateDynamically를 선택하지 않을 경우 이 값을 선택합니다.	String	Optional
Command	이 컨트롤에 대한 리본 명령의 ID를 지정합니다.	String	Optional
CommandMenuClose	메뉴가 닫힐 때 실행할 메뉴 명령의 ID를 지정합니다.	String	Optional
CommandMenuOpen	메뉴가 열릴 때 실행할 리본 명령의 ID를 지정합니다.	String	Optional
CommandType	다른 유형의 명령을 지정할 수 있습니다. Valid values:   Value Description General 특정 유형의 명령이 아닙니다. OptionSelection 사용자가 옵션 그룹에서 한 옵션을 선택할 때 생성되는 명령입니다. IgnoredByMenu 클릭할 때 메뉴를 닫으면 안 되는 컨트롤에 사용되는 명령입니다.	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 are defining a ribbon element that will be used for multiple entities. This will insert 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 중요 Failing to set a globally unique Id value can cause the ribbon not to 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
LabelText	컨트롤에 대한 텍스트로 표시할 문자열을 지정합니다. $LocLabels: 지시문(예: "$LocLabels:MyISV.account.Save.Button.Label")을 사용하여 LocLabel 요소를 참조할 수 있습니다.	String	Optional
MenuAlt	Alternative text to represent the menu.	String	Optional
MenuCommand	The name of the command to execute when the menu is clicked.	String	Optional
ModernImage	내부 전용입니다.	String	Optional
PopulateDynamically	이 컨트롤에 대한 옵션을 제공하는 메뉴 요소가 PopulateQueryCommand 특성에서 정의된 명령을 사용하여 런타임에 동적으로 채워지도록 지정합니다.	Boolean Default = false.	Optional
PopulateOnlyOnce	컨트롤이 동적으로 채워질 때 이 설정은 PopulateQueryCommand 특성에서 정의된 명령을 한 번만 호출해야 함을 나타납니다.	Boolean Default = false.	Optional
PopulateQueryCommand	컨트롤이 동적으로 채워질 때 이 명령은 이 컨트롤에 대한 옵션을 제공하는 메뉴 요소를 검색합니다.	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
ToolTipSelectedItemTitle	이 요소는 Microsoft Dynamics CRM에서 사용되지 않습니다.	String	Optional
ToolTipShortcutKey	이 요소는 Microsoft Dynamics CRM에서 사용되지 않습니다.	String	Optional
ToolTipTitle	컨트롤에 대한 도구 설명의 제목에 표시할 문자열을 지정합니다. 이는 일반적으로 컨트롤 LabelText과 동일한 값입니다. $LocLabels: 지시문(예: "$LocLabels:MyISV.account.Save.Button.Label")을 사용하여 LocLabel 요소를 참조할 수 있습니다.	String	Optional

하위 요소

Element	Description
<Menu> (RibbonDiffXml)	팝업 메뉴를 표시하는 데 사용되는 컨테이너를 지정합니다.

상위 요소

Element	Description
<CommandUIDefinition> (RibbonDiffXml)	CustomAction 요소 내에 포함될 시각적 리본 요소를 지정합니다.
<Controls> (RibbonDiffXml)	컨트롤의 모음이 들어 있습니다.

설명

If this element does not have any <Menu> elements and does not have a valid PopulateQueryCommand, the application will throw the following script error at run time: ‘attrs' is null or not an object.

요소 정보

XPath	//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/SplitButton | //Controls/SplitButton
Schema Name	SplitButtonType
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.