<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	指定功能区元素的定义的唯一标识符。强烈建议的命名约定是使用句点分隔名称的各个部分，如：[解决方案标识符].[实体].[功能区].[函数].[元素名称]。例如：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: 指令引用 LocLabel 元素，例如“$LocLabels:MyISV.account.Save.Button.Tooltip”。	String	Optional
ToolTipHelpKeyWord	本元素不用于 Microsoft Dynamics CRM。	String	Optional
ToolTipImage32by32	指定一个将与工具提示一起显示的 32x32 像素的图像。	String	Optional
ToolTipImage32by32Class	指定要应用于随工具提示一起显示的 32x32 像素的图像的 CSS 类。	String	Optional
ToolTipImage32by32Left	指定要将工具提示的 32x32 像素的图像左移的像素数。此数字可由负数表示。	Non Positive Integer	Optional
ToolTipImage32by32Top	指定要将工具提示的 32x32 像素的图像上移的像素数。此数字可由负数表示。	Non Positive Integer	Optional
ToolTipSelectedItemTitle	本元素不用于 Microsoft Dynamics CRM。	String	Optional
ToolTipShortcutKey	本元素不用于 Microsoft Dynamics CRM。	String	Optional
ToolTipTitle	指定要为控件的工具提示标题显示的字符串。这通常与控件 LabelText 的值相同。这可以使用 $LocLabels: 指令引用 LocLabel 元素，例如“$LocLabels:MyISV.account.Save.Button.Label”。	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)	不建议：指定用于指定表的维度的 10x10 网格。 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 元素中的可见 Ribbon 元素。
<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.