<Controls> (RibbonDiffXml)

  • 아티클

적용 대상: CRM 2016 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

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