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