Partilhar via


ui.refreshRibbon (referência da API do cliente)

Faz com que a faixa de opções reavalie os dados que controlam o que é exibido nela.

Sintaxe

formContext.ui.refreshRibbon(refreshAll);

Parâmetro

Nome Tipo Obrigatório Description
refreshAll booleano Não Indica se todas as barras de comandos da faixa de opções na página atual foram atualizadas. Se você especificar false, somente a barra de comandos da faixa de opções no nível da página será atualizada. Se você não especificar esse parâmetro, por padrão, false será passado.

Observações

Esta função é usada quando uma ação JavaScriptFunction da faixa de opções (RibbonDiffXml) altera os dados no formulário. Por exemplo, alterar o estado do registro por meio de uma ação da faixa de opções. Depois que o código alterar os dados usados por uma regra, use esse método para forçar a faixa de opções a reavaliar os dados no formulário para que a regra possa ser reaplicada.

Orientações

Para um desempenho ideal de suas cargas de formulário, você não deve usar essa função em EnableRule (RibbonDiffXml) ou onLoad (FormXml). O próprio carregamento do formulário aciona a avaliação de regras de todas as ações da faixa de opções. Caso você queira controlar a visibilidade de uma ação da faixa de opções, use promessas e padrão assíncrono no EnableRule.

formContext.ui
formContext