IRibbonUI.InvalidateControl(String) Método

Definición

Espacio de nombres:

Microsoft.Office.Core

Ensamblado:

office.dll

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

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

public void InvalidateControl (string ControlID);

abstract member InvalidateControl : string -> unit

Public Sub InvalidateControl (ControlID As String)

Parámetros

ControlID

String

Especifica el identificador del control que se invalidará.

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