Freigeben über

Hinzufügen einer neuen Schnittstelle in einem ATL-Projekt

  • Artikel

Wenn Sie einem Objekt oder Steuerelement eine Schnittstelle hinzufügen, erstellen Sie für jede Methode in dieser Schnittstelle Stub-out-Funktionen.Dem Objekt oder Steuerelement können nur Schnittstellen hinzugefügt werden, die sich derzeit in einer vorhandenen Typbibliothek befinden.Darüber hinaus muss durch die Klasse, in der Sie die Schnittstelle hinzufügen, das BEGIN_COM_MAP-Makro implementiert werden, bzw. das Projekt muss über das coclass-Attribut verfügen, falls es attributiert ist.

Sie können unter zwei Verfahrensweisen wählen, um dem Steuerelement eine neue Schnittstelle hinzuzufügen: manuell oder unter Verwendung der Code-Assistenten in der Klassenansicht.

So verwenden Sie Code-Assistenten in der Klassenansicht, um einem vorhandenen Objekt bzw. Steuerelement eine Schnittstelle hinzuzufügen

  1. Klicken Sie in der Klassenansicht mit der rechten Maustaste auf den Klassennamen eines Steuerelements.Hierbei kann es sich um ein standardmäßiges oder ein zusammengesetztes Steuerelement bzw. um eine beliebige andere Steuerelementklasse handeln, die ein BEGIN_COM_MAP-Makro in ihrer Headerdatei implementiert.

  2. Klicken Sie im Kontextmenü zunächst auf Hinzufügen und dann auf Schnittstelle implementieren.

  3. Wählen Sie die zu implementierenden Schnittstellen im Assistenten zum Implementieren von Schnittstellen aus.Wenn die Schnittstelle in keiner verfügbaren typelib enthalten ist, müssen Sie sie der IDL-Datei manuell hinzufügen.

So fügen Sie eine neue Schnittstelle manuell hinzu

  1. Fügen Sie der IDL-Datei die Definition der neuen Schnittstelle hinzu.

  2. Leiten Sie das Objekt oder Steuerelement von der Schnittstelle ab.

  3. Erstellen Sie ein neues COM_INTERFACE_ENTRY-Makro für die Schnittstelle, oder fügen Sie, falls das Projekt attributiert ist, das coclass-Attribut hinzu.

  4. Implementieren Sie die Methoden für die Schnittstelle.

Siehe auch

Aufgaben

Erstellen von Desktopprojekten mit Anwendungs-Assistenten

Referenz

ATL-Projekt-Assistent

Grundlagen von ATL-COM-Objekten

Standardmäßige ATL-Projektkonfigurationen

Konzepte

Visual C++-Projekttypen

Programmierung mit ATL und C-Laufzeit-Code