Método IRibbonUI.Invalidate (Office)
Invalida os valores em cache para todos os controles da interface do usuário Ribbon.
Sintaxe
expressão. Invalidar
Expressão Uma expressão que retorna um objeto IRibbonUI .
Comentários
Você pode personalizar a interface do usuário da Faixa de Opções usando procedimentos de retorno de chamada em suplementos COM. Para cada um dos retornos de chamada que o suplemento implementa, as respostas são armazenadas em cache.
Por exemplo, se um gravador de suplemento implementar o procedimento de retorno de chamada getImage para um botão, a função será chamada uma vez, a imagem será carregada e, em seguida, se a imagem precisar ser atualizada, a imagem armazenada em cache será usada em vez de recordar o procedimento. Esse processo permanece em vigor até que o suplemento sinalize que os valores armazenados em cache são inválidos usando o método Invalidate , momento em que o procedimento de retorno de chamada é novamente chamado e a resposta de retorno é armazenada em cache. O suplemento pode forçar uma atualização imediata da IU ao chamar o método Refresh.
Exemplo
No exemplo a seguir, iniciar o aplicativo host dispara o procedimento de evento onLoad que, em seguida, chama um procedimento que cria um objeto que representa a interface do usuário da faixa de opções. Em seguida, é definido um procedimento de retorno de chamada que invalida todos os controles da interface do usuário e atualiza a interface do usuário.
<customUI … OnLoad="MyAddinInitialize" …>
Dim MyRibbon As IRibbonUI
Sub MyAddInInitialize(Ribbon As IRibbonUI)
Set MyRibbon = Ribbon
End Sub
Sub myFunction()
MyRibbon.Invalidate() ' Invalidates the caches of all of this add-in's controls
End Sub
Confira também
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.