<Controls> (RibbonDiffXml)

아티클
12/05/2014

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

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

중요

The valid child elements of the Controls element depend on the parent element.

구문

<CommandUIDefinition>
 <Controls
  Id="String"
  ToolTipDescription="String"
  ToolTipHelpKeyWord="String"
  ToolTipImage32by32="String"
  ToolTipImage32by32Class="String"
  ToolTipImage32by32Left="NonPositiveInteger"
  ToolTipImage32by32Top="NonPositiveInteger"
  ToolTipTitle="String">
  [ 
    <Button /> |
    <CheckBox /> |
    <ComboBox /> |
    <ColorPicker /> |
    <ContextualGroup /> |
    <Controls /> |
    <DropDown /> |
    <FlyoutAnchor /> |
    <Gallery /> |
    <GalleryButton /> |
    <GroupTemplate /> |
    <Group /> |
    <Groups /> |
    <InsertTable /> |
    <Label /> |
    <MRUSplitButton /> |
    <MaxSize /> |
    <Menu /> |
    <MenuSection /> |
    <Scale /> |
    <Scaling /> |
    <Spinner /> |
    <SplitButton /> |
    <Tab /> |
    <TextBox/> |
    <ToggleButton />
   ]
 </Controls>
</CommandUIDefinition>

<MenuSection>
 <Controls
  Id="String"
  ToolTipDescription="String"
  ToolTipHelpKeyWord="String"
  ToolTipImage32by32="String"
  ToolTipImage32by32Class="String"
  ToolTipImage32by32Left="NonPositiveInteger"
  ToolTipImage32by32Top="NonPositiveInteger"
  ToolTipTitle="String">
  [ 
    <ToggleButton /> |
    <Button /> |
    <ColorPicker /> |
    <FlyoutAnchor /> |
    <InsertTable /> 
   ]
 </Controls>
</MenuSection>

특성 및 요소

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

특성

Attribute	Description	Type	Usage
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
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
<Button> (RibbonDiffXml)	작업을 수행하는 데 사용되는 간단한 단추를 지정합니다.
<CheckBox> (RibbonDiffXml)	옵션을 선택하는 데 사용되는 확인란을 지정합니다. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<ColorPicker> (RibbonDiffXml)	더 이상 사용되지 않습니다. 색 또는 스타일을 선택하는 데 사용되는 표를 지정했습니다. This element is only valid when Controls is a child of <MenuSection> (RibbonDiffXml)
<ComboBox> (RibbonDiffXml)	더 이상 사용되지 않습니다. 클릭하거나 입력하여 값을 선택하는 데 사용되는 목록을 지정했습니다. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<DropDown> (RibbonDiffXml)	더 이상 사용되지 않습니다. 클릭하여 값을 선택하는 데 사용되는 목록을 지정했습니다. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<FlyoutAnchor> (RibbonDiffXml)	메뉴를 여는 데 사용되는 아래쪽 화살표가 있는 단추를 지정합니다.
<GalleryButton> (RibbonDiffXml)	더 이상 사용되지 않습니다. 갤러리 요소 내에서 단추 컨트롤을 지정했습니다. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<InsertTable> (RibbonDiffXml)	더 이상 사용되지 않습니다. 테이블 크기를 지정하는 데 사용되는 10 x 10 표를 지정했습니다. This element is only valid when Controls is a child of <MenuSection> (RibbonDiffXml)
<Label> (RibbonDiffXml)	정보를 제공하는 데 사용되는 텍스트 줄을 지정합니다. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<MRUSplitButton> (RibbonDiffXml)	더 이상 사용되지 않습니다. 가장 최근에 사용한 항목을 표시하는 분할 단추 컨트롤을 지정했습니다. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<Spinner> (RibbonDiffXml)	값을 입력하거나 화살표 키를 눌러 값을 돌아가면서 선택하여 값을 삽입하는 데 사용되는 컨트롤을 지정합니다. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<SplitButton> (RibbonDiffXml)	단추와 메뉴로 모두 사용되는 컨트롤을 지정합니다. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<TextBox> (RibbonDiffXml)	더 이상 사용되지 않습니다. 텍스트를 입력하는 데 사용되는 컨트롤을 지정했습니다. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<ToggleButton> (RibbonDiffXml)	설정/해제 상태를 전환하는 데 사용되는 단추를 지정합니다.

상위 요소

Element	Description
<Group> (RibbonDiffXml)	공통의 레이아웃 템플릿을 공유하는 탭 내부의 컨트롤 그룹을 지정합니다.
<CommandUIDefinition> (RibbonDiffXml)	CustomAction 요소 내에 포함될 시각적 리본 요소를 지정합니다.
<MenuSection> (RibbonDiffXml)	메뉴를 분리하는 데 사용되는 섹션을 지정합니다. 메뉴 섹션에는 제목이 있을 수 있으며 컨트롤이 포함될 수 있습니다.

요소 정보

XPath	`//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Controls \| //RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Menu/MenuSection/Controls \| //RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/MenuSection/Controls`
Schema Name	ControlsType
Validation File	RibbonWSS.xsd
Can be Empty	Yes

참고 항목

기타 리소스

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

다음을 통해 공유