当前位置 > 支持 > 帮助中心 > Powerbi 帮助手册 > 在 Power BI 中进行开发 > Power BI 视觉对象 > 向自定义视觉对象添加功能

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

在“高级编辑”模式下，可以在 Power BI 视觉对象中使用高级 UI 控件。在“报表编辑”模式下，选择视觉对象上的“编辑”按钮，然后选择“高级编辑”模式。视觉对象使用 EditMode 标志来确定视觉对象是否显示“编辑 UI”控件。

Power BI 视觉对象的屏幕截图，其中显示了视觉对象菜单中的“编辑”按钮。

默认情况下，视觉对象不支持“高级编辑”模式 ("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 文件中设置的值，将发生以下操作：

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