Método IRibbonUI.InvalidateControl (Office)

Invalida el valor almacenado en caché de un control único en la interfaz de usuario de la cinta de opciones.

Sintaxis

expresión. InvalidateControl (bstrControlID)

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

Parameters

Nombre Obligatorio/opcional Tipo de datos Descripción
bstrControlID Obligatorio String Especifica el identificador del control que se invalidará.

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 para el control hasta que el complemento indica que los valores almacenados en caché no son válidos mediante el método InvalidateControl , 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é.

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 un control 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.InvalidateControl("control1") ' Invalidates the cache of a single control 
End Sub

Vea también

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.