Teilen über

Erstellen einer COM-Schnittstelle

Visual Studio stellt Assistenten und Vorlagen zum Erstellen von Projekten bereit, die definierende COM-Schnittstellen und Disp-Schnittstellen für Ihre COM-Objekte und Automatisierungsklassen verwenden.

Sie können diese Assistenten zum Ausführen der folgenden häufig benötigten Aufgaben verwenden:

  • Hinzufügen von ATL-Unterstützung zu einem MFC-Projekt

    Fügen Sie ATL-Unterstützung zu einer MFC-Anwendung hinzu, wenn Sie ein MFC-Projekt mithilfe des MFC-Anwendungs-Assistenten erstellt haben, und führen Sie den Codeassistenten zum Hinzufügen von ATL-Unterstützung zu MFC aus. Diese Unterstützung gilt nur für einfache COM-Objekte, die einer MFC-Anwendung oder einem DLL-Projekt hinzugefügt werden. Diese ATL-Objekte können über mehrere Schnittstellen verfügen.

  • Erstellen eines MFC-ActiveX-Steuerelements

    Öffnen Sie den MFC-ActiveX-Steuerelement-Assistenten, um ein ActiveX-Steuerelement mit einer Display-Schnittstelle und einer Ereigniszuordnung zu erstellen, die jeweils in der IDL-Datei und der Steuerelementklasse definiert werden.

  • Hinzufügen eines ATL-Steuerelements

    Verwenden Sie eine Kombination aus dem ATL-Projekt-Assistenten und dem ATL-Steuerelement-Assistenten, um ein ATL-ActiveX-Steuerelement zu erstellen.

    Sie können auch einem MFC-Projekt, dem Sie wie oben beschrieben ATL-Unterstützung hinzugefügt haben, ein ATL-Steuerelement hinzufügen. Darüber hinaus zeigt Visual Studio ein Dialogfeld zur Bestätigung des Hinzufügens von ATL-Unterstützung zu dem MFC-Projekt an, wenn Sie ATL-Steuerelement im Dialogfeld Klasse hinzufügen ausgewählt und dem MFC-Projekt noch keine ATL-Unterstützung hinzugefügt haben.

    Dieser Assistent generiert die IDL-Quelle und eine COM-Zuordnung in den Projektklassen.

Sobald Sie ein ATL-Projekt geöffnet haben, erhalten Sie im Dialogfeld Klasse hinzufügen eine Auswahl zusätzlicher Assistenten und Vorlagen zum Hinzufügen von COM-Schnittstellen zum Projekt. Mithilfe der folgenden Assistenten können Sie mehrere Schnittstellen für das Objekt erstellen:

Außerdem können Sie neue Schnittstellen für Ihre COM-Steuerelemente implementieren. Klicken Sie dafür erst mit der rechten Maustaste auf die Steuerelementklasse des Objekts in der Klassenansicht und anschließend mit der linken auf Schnittstelle implementieren.

Hinweis

Visual Studio stellt keinen Assistenten dafür bereit, Schnittstellen zu einem Projekt hinzuzufügen. Sie können Schnittstellen zu einem ATL-Projekt oder zu einem MFC-Projekt hinzufügen, zu dem von ATL-Unterstützung hinzugefügt wurde, indem Sie mithilfe des ATL-Assistenten für einfache Objekte ein einfaches Objekt hinzufügen. Öffnen Sie alternativ die IDL-Datei des Projekts, und erstellen Sie die Schnittstelle, indem Sie Folgendes eingeben:

interface IMyInterface {
};

Weitere Informationen finden Sie unter Implementieren einer Schnittstelle und Hinzufügen von Objekten und Steuerelementen zu einem ATL-Projekt.

Visual C++ bietet mehrere Möglichkeiten zum Anzeigen und Bearbeiten der COM-Schnittstellen, die für Ihre Projekte definiert sind. Die Klassenansicht zeigt Symbole für Schnittstellen oder Disp-Schnittstellen an, die in einer IDL-Datei in Ihrem Projekt definiert sind.

Bei ATL-basierten COM-Objektklassen liest die Klassenansicht die COM-Zuordnung in der ATL-Klasse zum Anzeigen der Beziehung zwischen der ATL-Klasse und allen Schnittstellen, die sie implementiert.

In der Klassenansicht und den zugehörigen Kontextmenüs können Sie wie folgt mit Schnittstellen arbeiten:

  • Fügen Sie ATL-Objekte zu einer MFC-basierten Anwendung hinzu.
  • Fügen Sie Methoden, Eigenschaften und Ereignisse hinzu.
  • Navigieren Sie direkt zum Schnittstellencode eines Elements, indem Sie auf das Element doppelklicken.

In diesem Abschnitt

Bearbeiten einer COM-Schnittstelle

Mithilfe der Befehle des Kontextmenüs der Klassenansicht können Sie neue Methoden und Eigenschaften für die COM-Schnittstellen in Ihren C++-Projekten in Visual Studio definieren. Darüber hinaus können Sie mit der Toolbox Ereignisse für ActiveX-Steuerelemente definieren.

Bei ATL- und MFC-basierten COM-Objektklassen können Sie die Implementierung der Klasse und die Schnittstelle zur gleichen Zeit bearbeiten.

Hinweis

Für Schnittstellen, die Sie außerhalb des Dialogfelds Klasse hinzufügen definiert haben, fügt Visual C++ die Methoden oder Eigenschaften der IDL-Datei und Stubs den Klassen hinzu, die Methoden implementieren, auch wenn die Schnittstellen manuell hinzugefügt werden.

Die folgenden drei Assistenten unterstützen Sie beim Anpassen vorhandener Schnittstellen. Sie sind in der Klassenansicht verfügbar:

Assistent Projekttyp
Assistent zum Hinzufügen von Eigenschaften ATL- oder MFC-Projekte, die ATL unterstützen. Klicken Sie mit der rechten Maustaste auf die Schnittstelle, der die Eigenschaft hinzugefügt werden soll.

Visual C++ erkennt den Projekttyp und ändert die Optionen im Assistenten zum Hinzufügen von Eigenschaften nach Bedarf:

– Für Disp-Schnittstellen in Projekten, die mit dem MFC-Anwendungs-Assistenten erstellt wurden, werden durch das Aufrufen des Assistenten zum Hinzufügen von Eigenschaften MFC-spezifische Optionen bereitgestellt.
– Für ActiveX-Steuerelementschnittstellen stellt der Assistent zum Hinzufügen von Eigenschaften eine Liste vordefinierter Methoden und Eigenschaften bereit, die Sie verwenden oder für Ihr Steuerelement anpassen können.
– Für alle anderen Schnittstellen stellt der Assistent zum Hinzufügen von Eigenschaften Optionen bereit, die in den meisten Situationen nützlich sind.
Assistent zum Hinzufügen von Methoden ATL- oder MFC-Projekte, die ATL unterstützen. Klicken Sie mit der rechten Maustaste auf die Schnittstelle, der die Methode hinzugefügt werden soll.

Visual C++ erkennt den Projekttyp und ändert die Optionen im Assistenten zum Hinzufügen von Methoden nach Bedarf:

– Für Disp-Schnittstellen in Projekten, die mit dem MFC-Anwendungs-Assistenten erstellt wurden, werden durch das Aufrufen des Assistenten zum Hinzufügen von Methoden MFC-spezifische Optionen bereitgestellt.
– Für ActiveX-Steuerelementschnittstellen stellt der Assistent zum Hinzufügen von Methoden eine Liste vordefinierter Methoden und Eigenschaften bereit, die Sie verwenden oder für Ihr Steuerelement anpassen können.
– Für alle anderen Schnittstellen stellt der Assistent zum Hinzufügen von Methoden Optionen bereit, die in den meisten Situationen nützlich sind.

Außerdem können Sie neue Schnittstellen für Ihre COM-Steuerelemente implementieren. Klicken Sie dafür erst mit der rechten Maustaste auf die Steuerelementklasse des Objekts in der Klassenansicht und anschließend mit der linken auf Schnittstelle implementieren.

  • Last updated on