分享方式：

定義功能區元素的縮放

  • 文章

 

發佈日期： 2016年11月

適用對象： Dynamics CRM 2015

應用程式功能區和更新的實體表單功能區沒有縮放功能。 縮放只適用於未更新的實體表單，以及使用 Microsoft Dynamics CRM 2015 for Outlook 顯示的清單功能區。

功能區的目的在於維持相關控制項的顯示狀態，即使視窗的水平大小改變。 若要達成此目標，UI 定義可讓您控制群組中的控制項如何變更大小來回應視窗大小的變更。 這稱為「縮放」(Scaling)。

讓群組和控制項產生關聯來配置範本

功能區中的每個 <Group> (RibbonDiffXml) 元素都與 <GroupTemplate> (RibbonDiffXml) 相關聯。GroupTemplate 會使用 <Layout> (RibbonDiffXml) 元素指定可顯示群組中控制項的一種或多種方式。 每個 Layout 可包含兩種類型的定義之一，表示控制項在群組中顯示的方式。

幾乎功能區中使用的所有 Layout 元素都使用 OverflowSection 元素。

每個 <Tab> (RibbonDiffXml) 元素必須包含一個在 <Scaling> (RibbonDiffXml) 中的 <MaxSize> (RibbonDiffXml)。MaxSize 元素是必要項，因為它會建立每個 Group 在 Tab 中的預設呈現方式，並且不套用任何縮放。 縮放會在 Tab 與一個或多個 <Scale> (RibbonDiffXml) 相關聯時發生。 每個 MaxSize 和 Scale 元素會透過 Size 屬性與 Tab 內每個 Group 使用的 GroupTemplate 的其中一個 Layout 元素相關聯。

備註

任何 MaxSize 或 Scale 元素的 Size 屬性值都必須符合 GroupTemplate 中指定的可用 Layout 元素的 Title。 這些值是字串，而 XSD 中沒有驗證方式可幫助您選取相符的值。XML 一律區分大小寫。

下圖顯示 MaxSize、Scale、Group、Layout 和 OverflowSection 元素必須互相參考以進行縮放的方式，當您使用 <OverflowSection> (RibbonDiffXml) 元素時。

OverflowSection 的元素關聯

下圖顯示 MaxSize、Scale、Group、Layout 和 ControlRef 元素必須互相參考以進行縮放的方式，當您使用 <Section> (RibbonDiffXml) 元素時。

Section 的元素關聯

使用現有的群組範本

建立新群組而非定義新群組範本時，可以重複使用現有的 GroupTemplate 元素。

將您的新群組與該範本產生關聯。 對於群組中的每個控制項，請使用來自其中一個 <Section> (RibbonDiffXml) 或 <OverflowSection> (RibbonDiffXml) 元素的 TemplateAlias 值，可在該 GroupTemplate 使用的其中一個 Layout 元素中找到。 每個 <OverflowSection> (RibbonDiffXml) 都包括一個 Microsoft Dynamics 365 未使用的 isvTemplateAlias。 這個 TemplateAlias 用於允許 ISV 將控制項新增至該群組。

控制套用縮放的方式

Scaling 元素中用於特殊索引標籤的每個 Scale 元素都代表一個縮放刻度。Scale 元素會依照 Scale 元素顯示的順序循序套用。 當縮減功能區可用的水平空間時，每個縮放元素會從上到下依序套用。 當增加可用的水平空間時，則最下方的縮放元素會從最小空間生效。 每個可用的 Scale 元素會從下到上依序套用，直到所有 MaxSize 元素生效。

備註

Scale 元素 Sequence 屬性值不會用來決定套用縮放的順序。 縮放是依照 MaxSize 和 Scale 元素在 RibbonDiffXML 中顯示的相對順序套用。Sequence 值對於 MaxSize 和 Scale 元素都很重要，因為所有 MaxSize 元素必須在 Scale 元素上方組合在一起。 當您新增新的 MaxSize 或 Scale 元素時，請務必檢閱指派給所有 MaxSize 元素和 Scale 元素的 Sequence 預設值範圍。 常見的錯誤是指派 Sequence 值，它可能會造成範圍重疊。

另請參閱

自訂命令和功能區
定義自訂動作來修改功能區
定義功能區索引標籤顯示規則

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