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 retorna um objeto IRibbonUI .
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| bstrControlID | Obrigatório | String | Especifica a identificação do controle que será invalidado. |
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 para o controle até que o suplemento sinalize que os valores armazenados em cache são inválidos usando o método InvalidateControl , momento em que o procedimento de retorno de chamada é novamente chamado e a resposta de retorno é armazenada em cache.
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 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
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.