IRibbonUI.Invalidate Método

Definición

Espacio de nombres:

Microsoft.Office.Core

Ensamblado:

office.dll

Invalida los valores almacenados en caché para todos los controles de la interfaz de usuario de la cinta de opciones.

public:
 void Invalidate();

public void Invalidate ();

abstract member Invalidate : unit -> unit

Public Sub Invalidate ()

Ejemplos

En el ejemplo siguiente, al iniciar la aplicación host desencadena el procedimiento de evento onLoad que, a continuación, llama a un procedimiento que crea un objeto que representa la interfaz de usuario de la cinta de opciones. A continuación, se define un procedimiento de devolución de llamada que invalida todos los controles de la interfaz de usuario y, a continuación, actualiza la interfaz de usuario.

A continuación se muestra el marcado XML de Office para cargar la cinta de opciones personalizada:

<customUI … onLoad=”MyAddInInitialize” …>

A continuación se muestra el método de devolución de llamada para el 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

Comentarios

Puede personalizar la interfaz de usuario de la cinta de opciones mediante procedimientos de devolución de llamada en complementos COM. Para cada una de las devoluciones de llamada que implementa el complemento, las respuestas se almacenan en caché. Por ejemplo, si un escritor de complementos implementa el procedimiento de devolución de llamada getImage para un botón, se llama a la función una vez, se carga la imagen y, a continuación, si la imagen necesita actualizarse, se usa la imagen almacenada en caché en lugar de recuperar el procedimiento. Este proceso permanece en contexto hasta que el complemento indica que los valores almacenados en caché no son válidos mediante el método Invalidate , momento en el que se llama de nuevo al procedimiento de devolución de llamada y la respuesta de devolución se almacena en caché. El complemento puede forzar una actualización inmediata de la interfaz de usuario llamando al método Refresh.