Adicionar um menu de contexto ao seu Power BI Visual

  • Artigo

Cada visual do Power BI pode exibir um menu de contexto. O menu de contexto permite executar várias operações no visual, como analisar, resumir ou copiá-lo. Quando você clica com o botão direito do mouse em qualquer lugar dentro do visor de um visual (ou pressiona e segura em dispositivos de toque), o menu de contexto é exibido. Há dois modos de menus de contexto para cada visual. O modo exibido depende do local em que você clica dentro do visual:

  • Chame o menu de contexto no espaço vazio para ver o menu de contexto básico para o visual.
  • Chame o menu de contexto em um ponto de dados específico para ver opções adicionais que podem ser aplicadas a esse ponto de dados. Nesse caso, o menu de contexto também contém as opções Mostrar ponto de dados como uma tabela, Incluir e Excluir que aplicará o filtro correspondente a esse ponto de dados.

Como adicionar um menu de contexto

Use selectionManager.showContextMenu() com os parâmetros selectionId e uma posição (como um objeto {x:, y:}) para que o Power BI exiba um menu de contexto para o seu visual.

Observação

  • O selectionManager.showContextMenu() está disponível apenas na API de Visuais versão 2.2.0. Para descobrir qual versão você está usando, verifique apiVersion no arquivo pbiviz.json.
  • Todos os visuais publicados no AppSource precisam dar suporte a ambos os modos ContextMenu (espaço vazio e ponto de dados).

O exemplo a seguir mostra como adicionar um menu de contexto a um visual. O código é retirado do arquivo barChart.ts, que faz parte do visual BarChart de exemplo:

constructor(options: VisualConstructorOptions) {
        ...
        this.handleContextMenu();
    }

private handleContextMenu() {
        this.rootSelection.on('contextmenu', (event: PointerEvent, dataPoint) => {
            this.selectionManager.showContextMenu(dataPoint ? dataPoint: {}, {
                x: mouseEvent.clientX,
                y: mouseEvent.clientY
            });
            mouseEvent.preventDefault();
        });
    }

Próximas etapas

Mais perguntas? Perguntar à Comunidade do Power BI