Método IRibbonUI.Invalidate (Office)

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

Sintaxis

expresión. Invalidar

expresión Expresión que devuelve un objeto IRibbonUI .

Observaciones

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 su lugar 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.

Ejemplo

En el ejemplo siguiente, al iniciar la aplicación host se 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.

<customUI … OnLoad="MyAddinInitialize" …>

Dim MyRibbon As IRibbonUI 
 
Sub MyAddInInitialize(Ribbon As IRibbonUI) 
 Set MyRibbon = Ribbon 
End Sub 
 
Sub myFunction() 
 MyRibbon.Invalidate() ' Invalidates the caches of all of this add-in's controls 
End Sub

Vea también

• Miembros del objeto IRibbonUI

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.