通过

<ContextualGroup> (RibbonDiffXml)

  • 项目

 

发布日期： 2017年1月

适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online

包含一个要在特定上下文中显示的选项卡集合。

语法

<ContextualGroup
 Color=[ "None" | "DarkBlue" | "LightBlue" | "Teal" | "Orange" | "Green" | "Magenta" | "Yellow" | "Purple"]
 Command="String"
 ContextualGroupId="String"
 Id="String"
 Sequence="Integer"
 Title="String" >
  <Tab />
</ContextualGroup>

特性和元素

下表列出了属性、子元素和父元素。

特性

属性

说明

类型​​

使用情况

颜色

为组指定颜色方案。

有效值包括：

  • 无​​

  • 深蓝

  • 浅蓝色

  • 青色

  • 橙色

  • 绿色

  • 紫红色

  • 黄色

  • 紫色

枚举

可选

Command

指定此控件的功能区命令的 ID。

字符串

可选

ContextualGroupId

确定上下文组的字符串，例如 Mscrm.VisualizationTools。

字符串

可选

ID

指定功能区元素的定义的唯一标识符。 强烈建议的命名约定是使用句点分隔名称的各个部分，如：[解决方案标识符].[实体].[功能区].[函数].[元素名称]。 例如：MyISV.account.form.SendToOtherSystem.Button。

当定义将用于多个实体的功能区元素时，请使用 Id 属性中的 {!EntityLogicalName} 令牌。 这可以将实体逻辑名称插入 Id 值，以确保 Id 值是全局唯一的。

例如，如果您使用 MyISV.{!EntityLogicalName}.form.SendToOtherSystem.Button 与客户实体，则 Id 将为 MyISV.account.form.SendToOtherSystem.Button。 对于联系人实体，Id 将为 MyISV.contact.form.SendToOtherSystem.Button。

重要

如果不设置全局唯一的 Id 值，可能不会显示功能区。

字符串

必选

序列

通过将序列值设置为高于或低于现有功能区元素来指定功能区修改内容的位置。

整型

可选

职务

Microsoft Dynamics 365 中未使用此元素。

字符串

可选

子元素

元素

说明

<Tab> (RibbonDiffXml)

指定功能区中的选项卡。

父元素

元素

说明

<CommandUIDefinition> (RibbonDiffXml)

指定要包含在 CustomAction 元素中的可见功能区元素。

备注

在导出您之前定义的 ContextualGroup 时，可能会发现 ContextualGroup 以及包含的所有 <Tab> (RibbonDiffXml) 元素重构到单个 <CustomAction> (RibbonDiffXml) 元素。 由于此方式，Microsoft Dynamics 365（在线或本地） 将数据存储在数据库中。 不更改原始定义的行为。

例如，如果您要定义 <CustomAction> (RibbonDiffXml) 以添加如下假代码段中显示的 ContextualGroup：

<CustomAction Location='Mscrm.ContextualGroups._children' >   <CommandUIDefinition>      <ContextualGroup Id='CG1'>         <Tab Id='T1'>...</Tab>         <Tab Id='T2'>...</Tab>      </ContextualGroup>   </CommandUIDefinition></CustomAction>

当您稍后导出自定义（包括此定义）时，您应该知道以下假代码段中所示的定义将会出现：

<CustomAction Location='Mscrm.ContextualGroups._children' >   <CommandUIDefinition>      <ContextualGroup Id='CG1' />   </CommandUIDefinition></CustomAction><CustomAction Location='CG1._children'>   <CommandUIDefinition>      <Tab Id='T1'>...</Tab>   </CommandUIDefinition></CustomAction><CustomAction Location='CG1._children'>   <CommandUIDefinition>      <Tab Id='T2'>...</Tab>   </CommandUIDefinition></CustomAction>

元素信息

XPath

 
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/ContextualGroup

架构名称

ContextualGroupType

验证文件

RibbonWSS.xsd

可以为空

是

另请参阅

自定义命令和功能区
Ribbon XML reference

Microsoft Dynamics 365

© 2017 Microsoft。 保留所有权利。 版权