“微件控制器”微件是一个容器，可用于将其他微件组织为工具栏。 可将控制器中微件的方向设置为水平或垂直。 可以控制可打开的微件数量以及微件按钮的显示方式。
示例
使用此微件可支持以下应用程序设计要求：
- 您希望在类似工具栏的控制器中组织微件。
- 您希望将微件添加到全屏地图，使其不占用太多空间。
- 您希望用户能够一次打开一个或多个微件以与地图进行交互。
用法说明
要将微件添加到控制器，请单击添加微件按钮，然后从微件库中选择，或者将微件从插入微件面板拖动到控制器上。 要配置已添加的微件，可通过单击控制器上的微件以打开其设置面板。 拖动微件面板的下角以定义其初始大小。
在运行时单击控制器中的微件打开其微件面板时，微件图标下方将显示一个指示线，表示微件处于活动状态。 可使用展开和折叠按钮更改面板在不完全关闭的情况下占据的空间数量。
单击管理微件按钮以查看控制器中所有微件的列表。 您可以重新排序微件、删除微件或将其放入组中。
群组
通过在管理微件面板中将微件拖动到另一个微件的顶部，可以在控制器中创建分组。 组是简单的“手风琴”微件。 它们非常有用，因为支持在控制器的一个面板中放置多个微件。 组具有与“手风琴”微件相同的所有设置，唯一的区别是它在页面大纲中被命名为组。 单击控制器中的组时，组中的微件将显示在带有展开和折叠按钮的垂直堆叠菜单中。
无面板微件
某些微件具有不适合控制器面板或无法适应的排列样式。 为了获得最佳显示效果，当您单击控制器图标时，这些微件会像正常情况下那样显示在控制器外部。 通常，当您将具有工具栏排列样式的微件添加到控制器并选择该排列样式时，它们会显示在面板外。
显示在面板外的微件包括“3D 工具箱”微件、“绘制”微件、“我的位置”微件、“共享”微件、“卷帘”微件和“时间线”微件。
设置
微件控制器微件包括以下设置：
- 方向 - 在控制器中垂直或水平显示微件。
- 对齐 - 选择如何对齐微件。 只有当控制器的宽度或高度大于微件的总长度时，您才会注意到这些选项的差异。
- 如果水平显示微件，则可以将它们与控制器的中心、左侧或右侧对齐。
- 如果垂直显示微件，则可以将它们与控制器的中心、顶部或底部对齐。
- 行为 - 定义可从此控制器打开的微件的数量，以及在加载页面时自动打开的微件。
- 单个 - 一次只能打开一个微件。 打开一个微件将关闭另一个微件。
- 多个 - 可以同时打开和运行多个微件。 在这种情况下，您可以选择堆叠或并排显示打开的微件。
提示：
要尝试这些选项，请单击构建器工具条上的实时视图。
- 通过从微件列表中进行选择，使页面加载时自动打开一个或多个微件。
- 显示类型 - 如果选择多个，则显示此设置。 选择使微件面板彼此堆叠或彼此相邻显示。
- 微件面板排列 - 如果选择单个，则显示此设置。 选择微件面板的显示位置：
- 浮动 - 微件面板显示为浮动在控制器旁边，固定到每个微件的图标。
- 固定 - 固定微件面板以显示在画布上 9 个锚点之一处。 您可以以像素 (px) 或画布百分比 (%) 为单位设置面板宽度和高度。 您还可以设置 x 轴和 y 轴的偏移量，并添加面板出现时显示的动画。
- 还可以将面板宽度和高度设置为拉伸。 如果这样做，则面板将拉伸为填充上、下、左和右边距内的画布区域，可以像素 (px) 或画布百分比 (%) 为单位定义这些边距。
- 外观 - 在“微件控制器”中选择微件，并自定义其图标、标注或样式。
- 图标 - 为微件图标使用圆形或矩形。
- 标注 - 将微件名称显示为图标下的标注。 可通过在设置面板或构建器轮廓中编辑微件名称更改这些标注。
- 指示器 - 包含指示微件处于活动状态的指示线。
- 工具提示 - 包含按钮的悬停文本。
- 大小 - 更改微件图标的大小。
- 间距 - 以像素 (px) 为单位指定微件图标之间的间距。
- 溢出样式 - 如果控制器的长度无法容纳过多的微件，则有两个选项可用于显示超出范围的微件：
- 箭头 - 添加用于导航控制器中所有微件的箭头。
- 弹出窗口 - 将标有更多微件的按钮添加到控制器的末尾。 当用户单击此按钮时，将出现一个窗口，列出其余的微件。
- 高级 - 选择控制器上按钮在三种状态下的显示方式：默认、选定和悬停。 如果打开标注，则可以更改字体颜色并将文本格式设置为粗体、斜体、删除线或下划线。 在图标样式下，可以更改图标颜色和背景颜色。 在阴影下，可以通过设置 x 偏移和 y 偏移、模糊半径、传播半径和阴影颜色来为图标添加阴影。
- 默认 - 用户未进行交互的按钮的默认状态。
- 选定 - 用户在控制器上选择的按钮或打开的微件的状态。
- 悬停 - 用户指向控制器上的按钮的状态。
注：
您选择的主题将影响配置选项中的颜色选择。 如果要使用不属于应用程序主题的颜色，则可以单击更多选择自定义颜色。
交互选项
可以使用按钮微件在控制器中打开微件。
为此，将“按钮”微件和“微件控制器”微件添加至您的应用程序。在按钮微件设置的操作选项卡中，单击添加触发器，然后选择按钮单击触发器。 选择“微件控制器”微件作为目标，选择打开微件操作，然后从操作设置下拉菜单中选择控制器中的微件。
还可以使用支持记录选择更改触发器的任何微件，在控制器中打开微件。 例如，您可以配置控制器中的表微件，使其在每次使用地图微件进行新选择时打开。
为此，请在“地图”微件的设置中添加记录选择更改触发器。 选择“微件控制器”微件作为目标，选择打开微件操作，然后从打开微件下的下拉菜单中选择“表”微件。 系统将提示您设置触发器数据，即触发消息操作的数据。 您可以从以下选项中选择：
- 所有数据 - 当用户从连接到源微件的任意数据源中选择要素时，打开微件。
- 自定义 - 使用特定图层作为触发器数据。 自定义触发器数据非常适用于需要由特定数据源触发消息动作的场景。 例如，如果您希望“图表”微件仅在用户选择地图上的某个城市时打开，可以选择城市图层作为触发器数据。
您还可以使用打开微件消息操作来选择要打开的微件。