定义功能区元素的缩放

  • 项目

 

发布日期： 2017年1月

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

对于应用程序功能区和更新的实体窗体功能区，没有缩放。 缩放仅适用于未更新的实体窗体和使用 Microsoft Dynamics 365 for Outlook 显示的列表功能区。

功能区的目的是当窗口的水平大小更改时用户依然能够看到相关控件。 为实现此目的，UI 定义允许您控制组中控件更改大小以响应窗口大小更改的方式。 这称为缩放。

将组和控件与布局模板相关联

功能区中的每个 <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 属性与 Layout 中每个 GroupTemplate 使用的 Group 中的 Tab 元素之一相关联。

备注

任何 Size 或 MaxSize 元素的 Scale 属性的值必须与 Title 中指定的可用 Layout 元素的 GroupTemplate 相匹配。 这些值是字符串，并且 XSD 中没有验证，以帮助您选择匹配值。XML 始终区分大小写。

下图显示在使用 <OverflowSection> (RibbonDiffXml) 元素时，MaxSize、Scale、Group、Layout 和 OverflowSection 元素如何必须相互引用以进行缩放。

与 OverflowSection 的元素关系

下图显示在使用 <Section> (RibbonDiffXml) 元素时，MaxSize、Scale、Group、Layout 和 ControlRef 元素如何必须相互引用以进行缩放。

与节之间的元素关系

使用现有组模板

在创建新组时，您可以重新使用现有 GroupTemplate 元素，而不必定义新的组模板。

将新组与该模板相关联。 对于组中的每个控件，可使用在该 TemplateAlias 使用的某个 Layout 元素中找到的 <Section> (RibbonDiffXml) 或 <OverflowSection> (RibbonDiffXml) 元素之一的 GroupTemplate 值。 每个 <OverflowSection> (RibbonDiffXml) 都包括 Microsoft Dynamics 365 没有使用的 isvTemplateAlias。 提供此 TemplateAlias 是为了允许 ISV 向该组中添加控件。

控制应用缩放的方式

特定选项卡上 Scale 元素中的每个 Scaling 元素表示一个缩放梯度。 按照 Scale 元素的显示顺序，依次应用每个 Scale。 在减小可用于功能区的水平空间时，将按从上到下的顺序应用每个 scale 元素。 在从最小空间增加可用水平空间时，底部的 scale 元素将生效。 按从下到上的顺序应用每个可用 Scale 元素，直到所有 MaxSize 元素都生效。

备注

Scale 元素 Sequence 属性值不用于确定应用缩放的顺序。 将按 MaxSize 和 Scale 元素在 RibbonDiffXML 中显示的相对顺序应用缩放。Sequence 值对 MaxSize 和 Scale 元素都很重要，因为必须在 MaxSize 元素的基础上将所有 Scale 元素分为一组。 在添加新的 MaxSize 或 Scale 元素时，应确保查看分派给所有 Sequence 元素和 MaxSize 元素的 Scale 默认值范围。 常见错误是分派可能导致范围重叠的 Sequence 值。

另请参阅

自定义命令和功能区
定义自定义操作以修改功能区
定义功能区选项卡显示规则

Microsoft Dynamics 365

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