Power BI 视觉对象中的视觉对象交互

有时,你想要允许用户通过选择、缩放或单击视觉对象来与其进行交互。 有时你希望视觉对象是静态的,这样用户就无法与该视觉对象进行交互。

视觉对象可以查询 allowInteractions 标志的值,该值指示视觉对象是否允许视觉对象交互。 例如,在查看或编辑报表时,视觉对象可以是交互式的,但在仪表板中查看时则不是交互式的。 这些交互包括单击、平移、缩放、选择和其他交互 。

注意

无论显示哪一个标志,最佳做法都是在所有场景中启用工具提示

设置交互式权限

在视觉对象的初始化过程中,allowInteractions 标志作为布尔值传递,充当 IVisualHost 接口的成员。

对于任何要求视觉对象不是交互式的 Power BI 场景(例如仪表板磁贴),请将 allowInteractions 标志设置为 false。 否则(例如报表),请将 allowInteractions 设置为 true

以下代码示例显示如何使用 allowInteractions 标志设置交互式权限。

   ...
   let allowInteractions = options.host.hostCapabilities.allowInteractions;
   bars.on('click', function(d) {
       if (allowInteractions) {
           selectionManager.select(d.selectionId);
           ...
       }
   });

有关使用 allowInteractions 标记的详细信息,请参阅 SampleBarChart 视觉对象存储库

视觉对象 API