Freigeben über

ATL-Assistent für einfache Objekte

  • Artikel

Dieser Assistent fügt dem Projekt ein minimales COM-Objekt hinzu. Auf dieser Seite des Assistenten legen Sie Namen fest, durch die die C++-Klasse sowie Dateien für das Objekt und seine COM-Funktionalität identifiziert werden.

Auf der Seite Optionen dieses Assistenten geben Sie das Threadmodell des Objekts und seine Aggregationsunterstützung an und legen fest, ob es duale Schnittstellen und die Automatisierung unterstützt. Darüber hinaus können Sie Unterstützung für die Fehlerinformationsschnittstelle, Verbindungspunkte, Internet Explorer-Unterstützung sowie freethreaded Marshalling aktivieren.

Hinweise

Ab Visual Studio 2008 registriert das von diesem Assistenten erstellte Registrierungsskript seine COM-Komponenten unter HKEY_CURRENT_USER statt unter HKEY_LOCAL_MACHINE. Um dieses Verhalten zu ändern, legen Sie die Option Komponente für alle Benutzer registrieren des ATL-Assistenten fest.

Namen

Geben Sie die Namen für Objekt, Schnittstelle und Klassen an, die dem Projekt hinzugefügt werden sollen. Mit Ausnahme von Kurzer Name können alle weiteren Felder unabhängig voneinander bearbeitet werden. Wenn Sie den Eintrag unter Kurzer Name ändern, wirkt sich die Änderung auf die Namen in allen anderen Feldern auf dieser Seite aus. Wenn Sie den Namen unter Coclass im COM-Abschnitt ändern, wirkt sich die Änderung auf die Felder Typ und Programm-ID aus, der Name unter Schnittstelle bleibt jedoch unverändert. Das Namenssystem ist so ausgelegt, dass alle Namen während der Entwicklung des Steuerelements leicht identifizierbar sind.

Tipp

Coclass kann nur bei nicht attributierten Projekten bearbeitet werden. Verfügt das Projekt über Attribute, kann Coclass nicht bearbeitet werden.

C++

Liefert Informationen zu der für das Objekt erstellten C++-Klasse.

  • Kurzer Name
    Legt den abgekürzten Namen für das Objekt fest. Der hier angegebene Name bestimmt die Namen unter Class und Coclass, die Namen der .cpp-Datei und .h-Datei, den Namen der Schnittstelle, die Namen unter Typ sowie die Programm-ID, sofern Sie diese Felder nicht einzeln ändern.

  • .h-Datei
    Legt den Namen der Headerdatei für die neue Objektklasse fest. Dieser Name basiert standardmäßig auf dem unter Kurzer Name angegebenen Namen. Klicken Sie auf die Schaltfläche mit den Auslassungspunkten (...), um den Dateinamen am gewünschten Speicherort zu speichern oder um die Klassendeklaration an eine vorhandene Datei anzufügen. Wenn Sie eine vorhandene Datei auswählen, wird sie vom Assistenten erst am ausgewählten Speicherort gespeichert, nachdem Sie im Assistenten auf Fertig stellen geklickt haben.

    Der Assistent ist nicht in der Lage, Dateien zu überschreiben. Wenn Sie den Namen einer vorhandenen Datei auswählen und dann auf Fertig stellen klicken, wird vom Assistenten eine Bestätigung angefordert, die Klassendeklaration an den Inhalt der Datei anzufügen. Klicken Sie auf Ja, um die Datei anzufügen, und klicken Sie auf Nein, um zum Assistenten zurückzukehren und einen anderen Dateinamen anzugeben.

  • Klasse
    Legt den Namen der zu erstellenden Klasse fest. Dieser Name basiert auf dem unter Kurzer Name angegebenen Namen. Allerdings wird der Buchstabe C als typisches Präfix für einen Klassennamen vorangestellt.

  • .cpp-Datei
    Legt für die neue Objektklasse den Namen der Implementierungsdatei fest. Dieser Name basiert standardmäßig auf dem unter Kurzer Name angegebenen Namen. Klicken Sie auf die Schaltfläche mit den Auslassungspunkten (...), um den Dateinamen am gewünschten Speicherort zu speichern. Die Datei wird erst am ausgewählten Speicherort gespeichert, wenn Sie im Assistenten auf Fertig stellen klicken.

    Der Assistent ist nicht in der Lage, Dateien zu überschreiben. Wenn Sie den Namen einer vorhandenen Datei auswählen und dann auf Fertig stellen klicken, werden Sie vom Assistenten gefragt, ob die Klassenimplementierung an den Inhalt der Datei angefügt werden soll. Klicken Sie auf Ja, um die Datei anzufügen, und klicken Sie auf Nein, um zum Assistenten zurückzukehren und einen anderen Dateinamen anzugeben.

  • Attributiert
    Gibt an, ob das Objekt Attribute verwendet. Wenn Sie einem attributierten ATL-Projekt ein Objekt hinzufügen, ist diese Option aktiviert und kann nicht geändert werden. Dies bedeutet, dass einem Projekt, das mit Attributunterstützung erstellt wurde, nur attributierte Objekte hinzugefügt werden können.

    Ein attributiertes Objekt kann lediglich einem ATL-Projekt hinzugefügt werden, das Attribute verwendet. Wenn Sie diese Option für ein ATL-Projekt auswählen, das nicht über Attributunterstützung verfügt, werden Sie vom Assistenten gefragt, ob dem Projekt Attributunterstützung hinzugefügt werden soll.

    Alle Objekte, die nach Auswahl dieser Option hinzugefügt wurden, werden automatisch als attributiert konfiguriert (das Kontrollkästchen ist aktiviert). Sie können das Kontrollkästchen deaktivieren, um ein Objekt hinzuzufügen, das keine Attribute verwendet.

    Weitere Informationen finden Sie unter Anwendungseinstellungen, ATL-Projekt-Assistent und Grundlegende Funktionsweise von Attributen.

COM

Bietet Informationen über die COM-Funktionen des Objekts.

  • Coclass
    Legt den Namen der Komponentenklasse fest. Sie enthält eine Liste der vom Objekt unterstützten Schnittstellen.

    Tipp

    Wenn Sie das Projekt unter Verwendung von Attributen erstellen oder auf der entsprechenden Seite dieses Assistenten angeben, dass das Objekt Attribute verwendet, können Sie diese Option nicht ändern, da das coclass-Attribut nicht in ATL enthalten ist.

  • type
    Legt die in der Registrierung verwendete Objektbeschreibung fest.

  • Interface
    Legt die für das Objekt erstellte Schnittstelle fest. Die Schnittstelle umfasst Ihre benutzerdefinierten Methoden.

  • Programm-ID
    Legt den Namen fest, den Container anstelle der CLSID des Objekts verwenden können.

Siehe auch

Aufgaben

Hinzufügen eines einfachen ATL-Objekts