Teilen über

ATL-Steuerelement-Assistent

  • Artikel

Fügt in ein ATL-Projekt (oder ein MFC-Projekt mit ATL-Unterstützung) ein ATL-Steuerelement ein. Sie können diesen Assistenten verwenden, um eine von drei Arten von Steuerelementen einzufügen:

  • Standardsteuerelement

  • Zusammengesetztes Steuerelement

  • DHTML-Steuerelement

Darüber hinaus können Sie ein minimales Steuerelement angeben und die Schnittstellen aus der Schnittstellenliste entfernen, die als Standard für Steuerelemente bereitgestellt werden, die in den meisten Containern geöffnet werden sollen. Sie können die für das Steuerelement unterstützten Schnittstellen auf der Seite "Schnittstellen" des Assistenten festlegen.

Hinweise

Das von diesem Assistenten erstellte Registrierungsskript registriert seine COM-Komponenten unter HKEY_CURRENT_USER anstelle von 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 das Objekt, die Schnittstelle und die Klassen an, das bzw. die Ihrem Projekt hinzugefügt werden sollen. Mit Ausnahme des Kurznamens können alle anderen Felder unabhängig voneinander geändert werden. Wenn Sie den Text für Kurzname ändern, spiegelt sich die Änderung in den Namen aller anderen Felder auf dieser Seite wider. Wenn Sie den Coclass-Namen im COM-Abschnitt ändern, wird die Änderung im Feld "Typ" widergespiegelt, aber der Schnittstellenname und die ProgID werden nicht geändert. Dieses Benennungsverhalten wurde so konzipiert, damit Sie beim Entwickeln der Steuerelemente alle Namen problemlos identifizieren können.

Hinweis

Coclass kann nur für nicht attributierte Steuerelemente bearbeitet werden. Wenn Ihr Projekt Attribute enthält, können Sie Co-Klasse nicht bearbeiten.

C++

Stellt Informationen für die C++-Klasse bereit, die zum Implementieren des Objekts erstellt wurde.

  • Kurzname

    Legt einen abgekürzten Namen für das Objekt fest. Der von Ihnen bereitgestellte Name bestimmt die Klassen- und Coclass-Namen , die Datei (. CPP und . H) Namen, den Schnittstellennamen und die Typnamen , es sei denn, Sie ändern diese Felder einzeln.

  • Klasse

    Legt den Namen der Klasse fest, die das Objekt implementiert. Dieser Name basiert auf dem Namen, den Sie unter Kurzname angeben. Dem Namen ist „C“ vorangestellt, das typische Präfix für einen Klassennamen.

  • H-Datei

    Legt den Namen der Headerdatei für die neue Klasse des Objekts fest. Standardmäßig basiert dieser Name auf dem Namen, den Sie unter Kurzname angeben. 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, wenn Sie auf "Fertig stellen" klicken.

    Der Assistent überschreibt Dateien nicht. Wenn Sie den Namen einer vorhandenen Datei auswählen, fordert der Assistent Sie dazu auf, anzugeben, ob die Klassendeklaration an die Inhalte der Datei angefügt werden sollen, wenn Sie auf Fertig stellen klicken. Klicken Sie auf Ja, um die Datei anzufügen. Klicken Sie auf Nein, um zum Assistenten zurückzukehren und einen anderen Dateinamen anzugeben.

  • CPP-Datei

    Legt den Namen der Implementierungsdatei für die neue Klasse des Objekts fest. Standardmäßig basiert dieser Name auf dem Namen, den Sie unter Kurzname angeben. Klicken Sie auf die Schaltfläche mit den Auslassungspunkten, um den Dateinamen am gewünschten Speicherort zu speichern. Die Datei wird nicht am ausgewählten Speicherort gespeichert, bis Sie im Assistenten auf Fertig stellen klicken.

    Der Assistent überschreibt Dateien nicht. Wenn Sie den Namen einer vorhandenen Datei auswählen, fordert der Assistent Sie dazu auf, anzugeben, ob die Klassenimplementierung an die Inhalte der Datei angefügt werden sollen, wenn Sie auf Fertig stellen klicken. Klicken Sie auf Ja, um die Datei anzufügen. Klicken Sie auf Nein, um zum Assistenten zurückzukehren und einen anderen Dateinamen anzugeben.

  • Attributiert

    Gibt an, ob das Objekt Attribute verwendet. Wenn Sie ein Objekt zu einem attributierten ATL-Projekt hinzufügen, wird diese Option ausgewählt und kann nicht geändert werden. Das bedeutet, dass Sie einem Projekt, das mit Attributunterstützung erstellt wurde, nur attributierte Objekte hinzufügen können.

    Sie können ein attributiertes Objekt nur zu einem ATL-Projekt hinzufügen, das Attribute verwendet. Wenn Sie diese Option für ein ATL-Projekt ohne Attributunterstützung auswählen, werden Sie vom Assistenten aufgefordert, anzugeben, ob Sie dem Projekt Attributunterstützung hinzufügen möchten.

    Standardmäßig werden alle Objekte, die Sie nach dem Festlegen dieser Option hinzufügen, als attributiert festgelegt (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 Mechanik von Attributen .

COM

Stellt Informationen über die COM-Funktionalität für das Objekt bereit.

  • Co-Klasse

    Legt den Namen der Komponentenklasse fest, die eine Liste der vom Objekt unterstützten Schnittstellen enthält.

    Hinweis

    Wenn Sie Ihr Projekt mithilfe von Attributen erstellen oder auf dieser Assistentenseite angeben, dass das Steuerelement Attribute verwendet, können Sie diese Option nicht ändern, da ATL das Coclass-Attribut nicht enthält.

  • Schnittstelle

    Legt den Namen der Schnittstelle für das Objekt fest. Standardmäßig wird ein Schnittstellenname mit "I" vorangestellt.

  • Typ

    Legt die Objektbeschreibung fest, die in der Registrierung angezeigt wird.

  • ProgID

    Legt den Namen fest, den Container anstelle der CLSID des Objekts verwenden können. Dieses Feld wird nicht automatisch ausgefüllt. Wenn Sie dieses Feld nicht manuell auffüllen, ist das Steuerelement möglicherweise nicht für andere Tools verfügbar. Beispielsweise sind ActiveX-Steuerelemente, die ohne einen ProgID generiert werden, im Dialogfeld "ActiveX-Steuerelement einfügen" nicht verfügbar. Weitere Informationen zu diesem Dialogfeld finden Sie unter ActiveX-Steuerelement einfügen.

Siehe auch

ATL-Steuerelement
Hinzufügen von Funktionen zum zusammengesetzten Steuerelement
Grundlagen von ARL COM-Objekten