Power BI 视觉对象中的高级编辑模式
- 版本 :2023.1(当前版本)
Power BI 视觉对象中的高级编辑模式
在“高级编辑”模式下,可以在 Power BI 视觉对象中使用高级 UI 控件。 在“报表编辑”模式下,选择视觉对象上的“编辑”按钮,然后选择“高级编辑”模式。 视觉对象使用 EditMode
标志来确定视觉对象是否显示“编辑 UI”控件。
默认情况下,视觉对象不支持“高级编辑”模式 ("advancedEditModeSupport: 0"
)。 若要启用“高级编辑”模式,请向视觉对象的 capabilities.json 文件添加一行来设置 advancedEditModeSupport
属性。
可能的值包括:
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
,则显示“返回报表”按钮。