Freigeben über


IRibbonExtensibility.GetCustomUI-Methode (Office)

Lädt das XML-Markup aus einer XML-Anpassungsdatei oder aus XML-Markup, das in die Prozedur eingebettet ist, mit der die Menüband-Benutzeroberfläche angepasst wird.

Syntax

Ausdruck. GetCustomUI (RibbonID)

Ausdruck Ein Ausdruck, der ein IRibbonExtensibility-Objekt zurückgibt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
RibbonID Erforderlich String Die ID für die RibbonX-Benutzeroberfläche.

Rückgabewert

String

Hinweise

Für Word, Excel, PowerPoint und Access müssen Sie nur eine ID für jede Anwendung vorhanden ist. Outlook verwendet die Menübanderweiterung, um nicht nur das Menüband in einem Inspektor, sondern auch das Menüband in einem Explorer, in verschiedenen Kontextmenüs, in kontextbezogenen Registerkarten auf einem Menüband und in der Microsoft Office Backstage-Ansicht anzupassen. In jedem dieser Szenarien gibt der Entwickler die benutzerdefinierte Benutzeroberfläche in eine XML-Datei, die geladen wird, wenn Office GetCustomUI mit einer bestimmten Menüband-ID aufruft

Beispiel

In der folgenden in c# geschriebenen Beispiel wird die IRibbonExtensibility -Schnittstelle in der Klassendefinition angegeben. Anschließend wird die Schnittstellen einzige Methode, GetCustomUI implementiert. Die -Methode erstellt eine instance eines StreamReader-Objekts, das das Anpassungsmarkup in einer externen XML-Datei einliest.

public class Connect : Object, Extensibility.IDTExtensibility2, IRibbonExtensibility 
... 
public string GetCustomUI(string RibbonID) 
{ 
 StreamReader customUIReader = new System.IO.StreamReader("C:\\RibbonXSampleCS\\customUI.xml"); 
 string customUIData = customUIReader.ReadToEnd(); 
 return customUIData; 
} 

Siehe auch

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.