Dela via


Visuella interaktioner i visuella Power BI-objekt

Ibland vill du tillåta att användaren interagerar med det visuella objektet genom att välja, zooma eller klicka på det. Andra gånger vill du att det visuella objektet ska vara statiskt, så att användaren inte kan interagera med det visuella objektet.

Visuella objekt kan fråga efter flaggans allowInteractions värde, vilket anger om det visuella objektet tillåter visuella interaktioner. Visuella objekt kan till exempel vara interaktiva under rapportvisning eller redigering, men visuella objekt kan vara icke-interaktiva när de visas på en instrumentpanel. Dessa interaktioner omfattar klick, panorering, zoom, markering och andra.

Kommentar

Bästa praxis är att aktivera knappbeskrivningar i alla scenarier, oavsett vilken flagga som anges.

Ange interaktiva behörigheter

Flaggan allowInteractions skickas som ett booleskt värde under initieringen av det visuella objektet som medlem i IVisualHost gränssnittet.

För alla Power BI-scenarion som kräver icke-interaktiva visuella objekt (till exempel paneler på instrumentpanelen) anger du allowInteractions flaggan till false. Annars (till exempel Rapport) anger du allowInteractions till true.

Följande kodexempel visar hur du allowInteractions använder flaggan för att ange interaktiva behörigheter.

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

Mer information om hur du använder allowInteractions flaggan finns i den visuella lagringsplatsen SampleBarChart.

Visuellt API