Power BI 视觉对象中的高级编辑模式

使用高级编辑模式,可以在 Power BI 视觉对象中使用高级 UI 控件。 在报表编辑模式下,选择视觉对象上的“编辑”按钮,并将编辑模式设置为“高级” 。 视觉对象使用 EditMode 标志来决定是否应显示此 UI 控件。

Screenshot that shows how to open Edit Mode.

默认情况下,视觉对象不支持高级编辑模式 ("advancedEditModeSupport: 0")。 若要启用“高级编辑”模式,请通过设置 advancedEditModeSupport 属性向视觉对象的 capabilities.json 文件添加一行代码。

可能的值包括:

  • 0 - NotSupported。 视觉对象不支持“高级编辑”模式。 此视觉对象上不显示“编辑”按钮。
  • 1 - SupportedNoAction。 该视觉对象支持“高级编辑”模式,且无需任何进一步更改。 Power BI 不会将该视觉对象切换到“焦点”模式。 开发人员可以使用此设置作为外部按钮,在同一视窗中运行多个进程。
  • 2 - SupportedInFocus。 该视觉对象支持“高级编辑”模式,并且在进入“高级编辑”模式时要求主机进入“焦点”模式。

进入高级编辑模式

如果出现以下情况,则会显示“编辑”按钮

  • 在 capabilities.json 文件中将 advancedEditModeSupport 属性设置为 SupportedNoActionSupportedInFocus
  • 在报表编辑模式下查看视觉对象。

如果 capabilities.json 文件中缺少属性 advancedEditModeSupport 或将其设置为 NotSupported,则不显示“编辑”按钮。

选择“编辑”时,视觉对象将获取 update() 调用,并将 EditMode 设置为 Advanced。 根据 capabilities.json 文件中设置的值,将发生以下操作

  • SupportedNoAction:主机不需要进一步操作。
  • SupportedInFocus:主机以“焦点”模式弹出视觉对象。

退出高级编辑模式

如果在 capabilities.json 文件中将 advancedEditModeSupport 属性设置为了 SupportedInFocus,则显示“返回报表”按钮。

后续步骤