IRibbonUI Schnittstelle

Definition

Namespace:

Microsoft.Office.Core

Assembly:

office.dll

Das Objekt, das von der im customUI-Tag angegebenen onLoad-Prozedur zurückgegeben wird. Das Objekt enthält Methoden, um Steuerelementeigenschaften ungültig zu machen und um die Benutzeroberfläche zu aktualisieren.

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

Attribute

GuidAttribute

Beispiele

Im folgenden Beispiel löst das Starten der Hostanwendung die onLoad-Ereignisprozedur aus, die dann eine Prozedur aufruft, die ein IRibbonUI-Objekt erstellt, das die Menüband-Benutzeroberfläche darstellt. Im nächsten Schritt wird eine Rückrufprozedur definiert, die alle Steuerelemente im Cache ungültig macht und anschließend die Benutzeroberfläche aktualisiert.

Es folgt das XML-Markup für Office zum Laden des benutzerdefinierten Menübands:

<customUI … onLoad=”MyAddInInitialize” …>

Es folgt die Rückrufmethode für das onLoad-Ereignis :

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

Hinweise

Sie können die Menüband-Benutzeroberfläche (UI) mit Callback-Prozeduren in COM-Add-Ins anpassen. Wenn die Hostanwendung gestartet wird, wird die onLoad-Callback-Prozedur aufgerufen. Anschließend gibt die Rückrufprozedur ein IRibbonUI-Objekt zurück, das auf die Benutzeroberfläche verweist. Mithilfe dieses Objekts können Sie die Methoden Invalidate, InvalidateControl und Refresh aufrufen.

Methoden

ActivateTab(String)	Aktiviert die angegebene benutzerdefinierte Registerkarte.
ActivateTabMso(String)	Aktiviert die angegebene integrierte Registerkarte.
ActivateTabQ(String, String)	Aktiviert die angegebene benutzerdefinierte Registerkarte auf der Menüband-Benutzeroberfläche von Microsoft Office Fluent. Verwendet den vollqualifizierten Namen der Registerkarte, der den Bezeichner und den Namespace der Registerkarte enthält.
Invalidate()	Macht die zwischengespeicherten Werte für alle Steuerelemente der Menüband-Benutzeroberfläche ungültig.
InvalidateControl(String)	Macht den zwischengespeicherten Wert für ein einzelnes Steuerelement der Menüband-Benutzeroberfläche ungültig.
InvalidateControlMso(String)	Mit dieser Methode wird ein integriertes Steuerelement für ungültig erklärt.