Freigeben über

Gewusst wie: Exportieren einer Multifunktionsleiste aus dem Multifunktionsleisten-Designer in Multifunktionsleisten-XML

  • Artikel

Aktualisiert: November 2007

Betrifft

Die Informationen in diesem Thema gelten nur für die angegebenen Visual Studio Tools for Office-Projekte und Versionen von Microsoft Office.

Projekttyp

  • Projekte auf Dokumentebene

  • Projekte auf Anwendungsebene

Microsoft Office-Version

  • Excel 2007

  • Word 2007

  • Outlook 2007

  • PowerPoint 2007

Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Das Element Multifunktionsleiste (Visual Designer) unterstützt nicht alle möglichen Typen der Multifunktionsleistenanpassung. Wenn Sie erweiterte Anpassungsoptionen für die Multifunktionsleiste nutzen möchten, können Sie die Multifunktionsleiste vom Designer nach Multifunktionsleisten-XML exportieren und das XML direkt bearbeiten.

Hinweis:

In der Multifunktionsleisten-XML-Datei werden nicht alle Eigenschaftenwerte angezeigt. Weitere Informationen hierzu finden Sie unter Übersicht über die Multifunktionsleiste.

So exportieren Sie eine Multifunktionsleiste vom Multifunktionsleisten-Designer nach Multifunktionsleisten-XML:

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Multifunktionsleisten-Codedatei, und klicken Sie danach auf Ansicht-Designer.

  2. Klicken Sie mit der rechten Maustaste auf den Multifunktionsleisten-Designer, und klicken Sie anschließend auf Multifunktionsleiste nach XML exportieren.

    Visual Studio Tools for Office fügt dem Projekt eine Multifunktionsleisten-XML-Datei und eine Multifunktionsleisten-XML-Codedatei hinzu.

  3. Suchen Sie in der Multifunktionsleisten-Codeklasse die Kommentare, die mit TODO:. beginnen.

  4. Kopieren Sie den Codeblock in diesen Kommentaren in die Klasse ThisAddin, ThisWorkbook oder ThisDocument, und zwar abhängig davon, welchen Projektmappentyp Sie entwickeln.

    Mit diesem Code kann die Microsoft Office-Anwendung die benutzerdefinierte Multifunktionsleiste erkennen und laden. Weitere Informationen finden Sie unter Multifunktionsleisten-XML.

  5. Nehmen Sie in der Klasse ThisAddin, ThisWorkbook oder ThisDocument eine Auskommentierung des Codeblocks vor.

    Nachdem Sie die Auskommentierung des Codes aufgehoben haben, sollte der Code etwa wie folgt aussehen. In diesem Beispiel wird die Multifunktionsleistenklasse als Ribbon1 bezeichnet.

    Protected Overrides Function CreateRibbonExtensibilityObject() As  _
Microsoft.Office.Core.IRibbonExtensibility
    Return New MyRibbon()
End Function

    protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject()
{
    return new MyRibbon();
}

  6. Wechseln Sie zur Multifunktionsleisten-XML-Codedatei, und suchen Sie den Bereich Ribbon Callbacks.

    Dort werden Rückrufmethoden zum Behandeln von Benutzeraktionen geschrieben (beispielsweise Klicken auf eine Schaltfläche).

  7. Erstellen Sie eine Rückrufmethode für jeden Ereignishandler, den Sie im Multifunktionsleisten-Designercode geschrieben haben.

  8. Verschieben Sie den gesamten Ereignishandlercode von den Ereignishandlern zu den Rückrufmethoden, und ändern Sie den Code so, dass er mit dem Programmiermodell für die Erweiterbarkeit von Mutlifunktionsleisten (RibbonX) kompatibel ist.

    Weitere Informationen zum Schreiben von Rückrufmethoden und zum Verwenden des RibbonX-Programmiermodells finden Sie unter Multifunktionsleisten-XML.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Erstellen einer benutzerdefinierten Registerkarte mit dem Multifunktionsleisten-Designer

Exemplarische Vorgehensweise: Erstellen einer benutzerdefinierten Registerkarte mit Multifunktionsleisten-XML

Konzepte

Übersicht über die Multifunktionsleiste

Multifunktionsleisten-Designer

Multifunktionsleisten-XML