IRibbonUI Interfaz

Definición

Espacio de nombres:

Microsoft.Office.Core

Ensamblado:

office.dll

El objeto devuelto por el procedimiento onLoad especificado en la etiqueta customUI. El objeto contiene métodos para invalidar las propiedades de control y para actualizar la interfaz de usuario.

public interface class IRibbonUI

[System.Runtime.InteropServices.Guid("000C03A7-0000-0000-C000-000000000046")]
public interface IRibbonUI

[<System.Runtime.InteropServices.Guid("000C03A7-0000-0000-C000-000000000046")>]
type IRibbonUI = interface

Public Interface IRibbonUI

Atributos

GuidAttribute

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 IRibbonUI que representa a 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 almacenados en caché 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 (UI) de la cinta de opciones mediante procedimientos de devolución de llamada en complementos COM. Cuando se inicia la aplicación host, se llama al procedimiento de devolución de llamada onLoad . El procedimiento de devolución de llamada devuelve entonces un objeto IRibbonUI que señala a la interfaz de usuario. Puede utilizar dicho objeto para invocar los métodos Invalidate, InvalidateControl y Refresh.

Métodos

ActivateTab(String)	Activa la ficha personalizada que se especificó.
ActivateTabMso(String)	Activa la ficha integrada especificada.
ActivateTabQ(String, String)	Activa la ficha personalizada que se especificó en la interfaz de usuario de cinta de Microsoft Office Fluent. Usa el nombre completo de la pestaña, que incluye el identificador y el espacio de nombres de la pestaña.
Invalidate()	Invalida los valores almacenados en caché para todos los controles de la interfaz de usuario de la cinta de opciones.
InvalidateControl(String)	Invalida el valor almacenado en caché de un control único en la interfaz de usuario de la cinta de opciones.
InvalidateControlMso(String)	Se usa para invalidar un control integrado.