Método IRibbonUI.InvalidateControl (Office)

Invalida o valor em cache de um controle exclusivo na interface do usuário Ribbon.

Sintaxe

expressão. InvalidateControl (bstrControlID)

expressão Uma expressão que devolve um objeto IRibbonUI .

Parâmetros

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 para o controlo até que o suplemento sinalize que os valores em cache são inválidos através do método InvalidateControl , altura em que o procedimento de chamada de retorno é novamente chamado e a resposta de retorno é colocada em cache.

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 um controle 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.InvalidateControl("control1") ' Invalidates the cache of a single control 
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.