ConnXL Docs

Personalizar

Botões do friso

Adiciona botões personalizados ao friso do Excel que abrem o teu painel de tarefas, executam uma das tuas funções ou lançam uma caixa de diálogo — colocados num separador incorporado ou no teu próprio separador com marca.

6 min de leitura

Na página Resources → Ribbon buttons de um ambiente, adiciona controlos que aparecem diretamente no friso do Excel — sem precisares de abrir o painel de tarefas. Cada botão tem uma etiqueta, uma dica, um ícone, uma colocação de separador e uma de três ações.

Tipos de ação

FieldTypeDescription
show_taskpaneOptional
Mostrar painel de tarefasAbre o teu painel de tarefas — o lançador incorporado. Funciona em qualquer separador, incorporado ou personalizado.
execute_functionOptional
Executar funçãoInsere =NAMESPACE.MODULE.FN() na célula ativa sem argumentos — só podes atribuir funções sem parâmetros obrigatórios. Tem de estar no teu separador personalizado.
open_dialogOptional
Abrir caixa de diálogoLança uma das tuas caixas de diálogo configuradas, que recolhe dados de entrada e insere a fórmula composta. Tem de estar no teu separador personalizado.

Uma função que precisa de dados de entrada fica atrás de uma caixa de diálogo

Um botão Executar função insere diretamente uma fórmula sem argumentos, por isso só lhe podes atribuir funções com todos os parâmetros opcionais. Uma função que primeiro precisa de um valor — um id de cliente, um intervalo de datas — fica atrás de um botão Abrir caixa de diálogo, que recolhe o dado antes de inserir a fórmula.

Colocação

Os botões ficam num separador incorporado do Excel (Home, Insert, Formulas, Data, Review, View) ou no separador personalizado do teu suplemento. Os separadores incorporados só podem alojar botões Mostrar painel de tarefas — os botões Executar função e Abrir caixa de diálogo precisam sempre do separador personalizado, porque o Office reserva os separadores incorporados só para o lançador.

Renomeia o teu separador personalizado a partir dessa mesma página de Botões do friso; por predefinição usa o nome de marca do teu suplemento. Consulta Marca branca para o resto dos controlos de marca do suplemento.

Ícones e ordem

Carrega um PNG, JPEG, WEBP, GIF ou SVG — é rasterizado no servidor em variantes de 16/32/80px — ou escolhe um já presente na biblioteca de ícones da tua organização. Reordena os botões com as pegas de arrastar na lista; a ordem que definires aí é a ordem em que o Excel os apresenta dentro do seu grupo.

O limite de doze botões

Cada ambiente pode definir até 12 botões de friso. O botão de criar no dashboard desativa-se ao atingir o limite — elimina ou reaproveita um para adicionar outro.

A maioria das alterações precisa de reimplementar o manifesto

Adicionar, remover, renomear, reordenar, restilizar ou trocar o ícone de um botão altera o manifesto do Office — os teus utilizadores precisam de o reinstalar antes de o Excel mostrar a alteração. A única exceção é o retargeting: apontar um botão existente de Executar função ou Abrir caixa de diálogo para uma função ou caixa de diálogo diferente aplica-se em direto, sem reimplementação, porque a identidade do botão no manifesto nunca muda.

Nesta página