Visuelle Interaktionen in Power BI-Visuals

Manchmal soll der Benutzer mit dem Visual interagieren können, indem er eine Auswahl trifft, es vergrößert oder darauf klickt. In anderen Situationen soll das Visual statisch sein, sodass der Benutzer nicht mit dem Visual interagieren kann.

Visuals können den Wert des allowInteractions-Flags abfragen, das angibt, ob das Visual visuelle Interaktionen zulässt. Beispielsweise können Visuals während der Anzeige oder Bearbeitung von Berichten sein. Beim Anzeigen von Visuals in einem Dashboard können sie jedoch nicht-interaktiv sein. Interaktionen können beispielsweise Klick-, Schwenk-, Zoom- und Auswahlaktionen umfassen.

Hinweis

Die Aktivierung von QuickInfos wird in allen Szenarien unabhängig von der angegebenen Kennzeichnung empfohlen.

Festlegen interaktiver Berechtigungen

Das allowInteractions-Flag wird während der Initialisierung des Visuals in Form als Member der Schnittstelle IVisualHost als boolescher Wert übergeben.

In allen Power BI-Szenarios, in denen Visuals nicht-interaktiv sein müssen (beispielsweise in Dashboardkacheln), ist das allowInteractions-Flag auf false festgelegt. Ansonsten (beispielsweise in einem Bericht) ist das allowInteractions-Flag auf true festgelegt.

Im folgenden Codebeispiel wird veranschaulicht, wie Sie das allowInteractions Flag verwenden, um interaktive Berechtigungen festzulegen.

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

Weitere Informationen zur Verwendung des allowInteractions-Flags finden Sie unter Visuelles SampleBarChart-Repository.

Zugehöriger Inhalt

Visual-API