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 devolve um objeto IRibbonUI .

Comentários

Pode personalizar a IU do Friso através de procedimentos de chamada de retorno em suplementos COM. Para cada uma das chamadas de retorno implementadas pelo suplemento, as respostas são colocadas em cache.

Por exemplo, se um escritor de suplementos implementar o procedimento de chamada de retorno getImage para um botão, a função é chamada uma vez, a imagem é carregada e, em seguida, se a imagem precisar de ser atualizada, a imagem em cache é utilizada em vez de recuperar o procedimento. Este processo permanece em vigor até que o suplemento indique que os valores em cache são inválidos ao utilizar o método Invalidate , altura em que o procedimento de chamada de retorno é novamente chamado e a resposta de retorno é colocada em cache. O suplemento pode forçar uma atualização imediata da IU ao chamar o método Refresh.

Exemplo

No exemplo seguinte, iniciar a aplicação anfitriã aciona o procedimento de evento onLoad que, em seguida, chama um procedimento que cria um objeto que representa a IU do Friso. 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

• Membros do objeto IRibbonUI

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.