Compartilhar via


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

Faz com que a faixa de opções avalie novamente os dados que controlam o que é exibido nele.

Sintaxe

formContext.ui.refreshRibbon(refreshAll);

Parâmetro

Nome Tipo Obrigatório Description
refreshAll booleano Não Indica se todas as barras de comando da faixa de opções na página atual são 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

Essa função é usada quando uma ação da faixa de opções JavaScriptFunction (RibbonDiffXml) altera os dados no formulário. Por exemplo, alteração do estado do registro por meio de uma ação de 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ção

Para obter o desempenho ideal das cargas de formulário, você não deve usar essa função em EnableRule (RibbonDiffXml) ou onLoad (FormXml). A carga do formulário em si dispara a avaliação de regras de todas as ações da faixa de opções. Caso deseje controlar a visibilidade de uma ação de faixa de opções, use promessas e padrão assíncrono em EnableRule.

formContext.ui
formContext