IRibbonUI.Invalidate Método

Definição

Namespace:

Microsoft.Office.Core

Assembly:

office.dll

Invalida os valores em cache para todos os controles da interface do usuário Ribbon.

public:
 void Invalidate();

public void Invalidate ();

abstract member Invalidate : unit -> unit

Public Sub Invalidate ()

Exemplos

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.

A seguir está a marcação XML para o Office carregar a faixa de opções personalizada:

<customUI … onLoad=”MyAddInInitialize” …>

A seguir está o método de retorno de chamada para o evento onLoad :

Dim MyRibbon As IRibbonUI
Sub MyAddInInitialize(Ribbon As IRibbonUI)
    Set MyRibbon = Ribbon
End Sub

Sub myFunction()
    ‘ Invalidates the caches of all of this add-in’s controls 
    MyRibbon.Invalidate()            
End Sub

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 in loco 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.