分享方式：

<ContextualGroup> (RibbonDiffXml)

  • 文章

 

發佈日期： 2016年11月

適用對象： Dynamics CRM 2015

包含要在特定內容內顯示的索引標籤集合。

語法

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

屬性與元素

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

屬性

屬性

描述

類型

使用方式

色彩

針對群組指定色彩配置。

有效值包含：

  • 無​​

  • DarkBlue

  • LightBlue

  • Teal

  • Orange

  • 綠色

  • Magenta

  • Yellow

  • Purple

列舉

列席者

命令

指定此控制項的功能區命令識別碼。

字串

列席者

ContextualGroupId

識別關聯式群組的字串，例如 Mscrm.VisualizationTools。

字串

列席者

識別碼

為功能區元素定義指定唯一識別碼。強烈建議的命名慣例是使用句號分隔名稱的各個部分，如下：[solution identifier].[entity].[ribbon].[function].[element name]。例如：MyISV.account.form.SendToOtherSystem.Button。

當您定義要用於多個實體的功能區元素時，在 Id 屬性中使用 {!EntityLogicalName} Token。這會將實體邏輯名稱插入至 Id 值，確定 Id 值是全域唯一的。

例如，如果您使用 MyISV.{!EntityLogicalName}.form.SendToOtherSystem.Button 與客戶實體，Id 是 MyISV.account.form.SendToOtherSystem.Button。如果是連絡人實體，Id 是 MyISV.contact.form.SendToOtherSystem.Button。

重要

如果未設定全域唯一 Id 值，功能區不會顯示。

字串

出席者

序列

藉由將 Sequence 值設定為高於或低於現有功能區元素，以指定功能區修改的位置。

整數

列席者

標題

此元素未使用於 Microsoft Dynamics CRM。

字串

列席者

子元素

項目

描述

<Tab> (RibbonDiffXml)

指定功能區中的索引標籤。

父元素

項目

描述

<CommandUIDefinition> (RibbonDiffXml)

指定要包含在 CustomAction 元素中的可見 Ribbon 元素。

備註

在匯出之前定義 ContextualGroup 時，可能會看到 ContextualGroup 和其中包含的所有 <Tab> (RibbonDiffXml) 元素重構為不同 <CustomAction> (RibbonDiffXml) 元素。這是因為 Microsoft Dynamics CRM 2015 和 Microsoft Dynamics CRM Online 2015 更新 在資料庫中儲存資料的方式。不變更原始定義的行為。

例如，如果您定義 <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

© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權