IRibbonUI.InvalidateControl(String) Método

public:
 void InvalidateControl(System::String ^ ControlID);

public void InvalidateControl (string ControlID);

abstract member InvalidateControl : string -> unit

Public Sub InvalidateControl (ControlID As String)

Parâmetros

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 um controle 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:

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 cache of a single control 
    MyRibbon.InvalidateControl(“control5”)            
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 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.

Aplica-se a