Power BI 视觉对象中的高级编辑模式
使用高级编辑模式可以在 Power BI 视觉对象中使用高级 UI 控件。 在报表编辑模式下,选择视觉对象上的 “编辑”按钮,并将编辑模式设置为 高级。 视觉对象使用 EditMode
标志来确定它是否应显示此 UI 控件。
默认情况下,视觉对象不支持高级编辑模式("advancedEditModeSupport: 0"
)。 若要启用高级编辑模式,请通过设置 advancedEditModeSupport
属性将行添加到视觉对象的 capabilities.json 文件中。
可能的值包括:
0
- 不支持。 视觉对象不支持高级编辑模式。 此视觉对象上不显示“编辑”按钮。1
- SupportedNoAction。 视觉对象支持高级编辑模式,不需要进行任何进一步更改。 Power BI 不会将视觉对象切换到 焦点 模式。 开发人员可以使用此设置作为外部按钮在同一视区中运行多个进程。2
- SupportedInFocus。 视觉对象支持高级编辑模式,并且要求主机进入高级编辑模式时进入焦点模式。
进入高级编辑模式
如果满足以下条件,则会显示 “编辑”按钮:
advancedEditModeSupport
属性在 capabilities.json 文件中设置为SupportedNoAction
或SupportedInFocus
。- 在报表编辑模式下查看视觉对象。
如果 advancedEditModeSupport
属性在 capabilities.json 文件中缺失或设置为 NotSupported
,则 “编辑”按钮不会出现。
选择 编辑时,视觉对象将获取一个 update()调用,并将 EditMode 设置为 Advanced
。 根据 capabilities.json 文件中设置的值,将执行以下操作:
SupportedNoAction
:主机不需要进一步的操作。SupportedInFocus
:主机以“焦点”模式弹出视觉对象。
您可以在 Power BI 视觉对象的 功能和属性中了解如何配置 capabilities.json 文件。
退出高级编辑模式
如果在 capabilities.json 文件中将 advancedEditModeSupport
属性设置为 SupportedInFocus
,将显示 返回报表 按钮。