Partilhar via


Interações visuais em visuais do Power BI

Às vezes, você quer permitir que o usuário interaja com o visual selecionando, ampliando ou clicando nele. Outras vezes você quer que o visual seja estático, para que o usuário não possa interagir com o visual.

Os elementos visuais podem consultar o valor do sinalizador, que allowInteractions indica se o visual permite interações visuais. Por exemplo, os elementos visuais podem ser interativos durante a visualização ou edição de relatórios , mas os elementos visuais podem não ser interativos quando são exibidos em um painel. Essas interações incluem clique, panorâmica, zoom, seleção e outros.

Nota

A prática recomendada é habilitar dicas de ferramentas em todos os cenários, independentemente do sinalizador indicado.

Definir permissões interativas

O allowInteractions sinalizador é passado como um valor booleano durante a inicialização do visual como um membro da IVisualHost interface.

Para qualquer cenário do Power BI que exija visuais não interativos (por exemplo, blocos de painel), defina o sinalizador allowInteractions como false. Caso contrário (por exemplo, Relatório), defina allowInteractions como true.

O exemplo de código a seguir mostra como usar o allowInteractions sinalizador para definir permissões interativas.

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

Para obter mais informações sobre como usar o allowInteractions sinalizador, consulte o repositório visual SampleBarChart.

Visual API