Hinzufügen eines Steuerelements (ATL-Lernprogramm, Teil 2)
In diesem Schritt fügen Sie Ihrem Projekt ein Steuerelement hinzu, erstellen es und testen es auf einer Webseite.
Prozeduren
So fügen Sie einem ATL-Projekt ein Objekt hinzu
Klicken Sie in der Klassenansicht mit der rechten Maustaste auf das Projekt "Polygon".
Zeigen Sie auf Hinzufügen im Kontextmenü, und klicken Sie im Untermenü auf Klasse.
Das Dialogfeld Klasse hinzufügen wird angezeigt. Die verschiedenen Objektkategorien werden in der Baumstruktur links aufgeführt.
Klicken Sie auf den Ordner ATL.
In der Liste der Vorlagen auf der rechten Seite, wählen Sie ATL-Steuerelement aus. Klicken Sie auf Hinzufügen. Der ATL-Steuerelement-Assistent wird geöffnet, und Sie können das Steuerelement konfigurieren.
Geben Sie PolyCtl als den Kurznamen ein, und beachten Sie, dass die anderen Felder automatisch vervollständigt werden. Klicken Sie noch nicht auf Fertig stellen, da Sie einige Änderungen vornehmen müssen.
Die Seite Namen des ATL-Steuerelement-Assistenten enthält die folgenden Felder:
Feld |
Inhalt |
|---|---|
Kurzer Name |
Der Name, den Sie für das Steuerelement eingegeben haben. |
Klasse |
Der C++-Klassenname, der erstellt wurde, um das Steuerelement zu implementieren. |
.h-Datei |
Die Datei, die erstellt wurde, um die Definition der C++-Klasse zu enthalten. |
.cpp-Datei |
Die Datei, die erstellt wurde, um die Implementierung der C++-Klasse zu enthalten. |
Coclass |
Der Name der Komponentenklasse für dieses Steuerelement. |
Schnittstelle |
Der Name der Schnittstelle, auf der das Steuerelement die benutzerdefinierten Methoden und Eigenschaften implementiert. |
Typ |
Eine Beschreibung für das Steuerelement. |
ProgID |
Der lesbare Name, der verwendet werden kann, um die CLSID des Steuerelements zu suchen. |
Sie müssen einige zusätzliche Einstellungen im ATL-Steuerelement-Assistenten vornehmen.
So aktivieren Sie die Unterstützung für aussagekräftige Fehlerinformationen und Verbindungspunkte
Klicken Sie auf Optionen, um die Seite Optionen zu öffnen.
Aktivieren Sie das Kontrollkästchen Verbindungspunkte. Dadurch wird die Unterstützung einer Ausgangsschnittstelle in der IDL-Datei erstellt.
Sie können das Steuerelement auch einfügbar machen. Das heißt, es kann in Anwendungen eingebettet werden, die eingebettete Objekten unterstützen, wie z. B. Excel oder Word.
So machen Sie das Steuerelement einfügbar
Klicken auf Darstellung, um die Seite Darstellung zu öffnen.
Aktivieren Sie das Kontrollkästchen Einfügbar.
Das Polygon, das durch das Objekt angezeigt wird, verfügt über einfarbige Füllung. Deshalb müssen Sie eine Fill Color-Basiseigenschaft hinzufügen.
So fügen Sie eine Füllfarben-Basiseigenschaft hinzu und erstellen das Steuerelement
Klicken auf Basiseigenschaften, um die Seite Basiseigenschaften zu öffnen.
Führen Sie unter Nicht unterstützt auf der Liste möglicher Basiseigenschaften den Bildlauf nach unten durch. Doppelklicken Sie auf Fill Color, um es in die Liste Unterstützt zu verschieben.
Dies vervollständigt die Optionen für das Steuerelement. Klicken Sie auf Fertig stellen.
Während der Assistent das Steuerelement erstellte, wurden mehrere Codeänderungen und Dateihinzufügungen ausgeführt. Die folgenden Dateien wurden erstellt:
Datei |
Beschreibung |
|---|---|
PolyCtl.h |
Sie enthält den größten Teil der Implementierung der C++-Klasse CPolyCtl. |
PolyCtl.cpp |
Sie enthält die verbleibenden Teile von CPolyCtl. |
PolyCtl.rgs |
Eine Textdatei, die das Registrierungsskript enthält, das verwendet wird, um das Steuerelement zu registrieren. |
PolyCtl.htm |
Eine Webseite, die einen Verweis auf das neu erstellte Steuerelement enthält. |
Der Assistent führt auch die folgenden Codeänderungen aus:
Er fügte den Dateien "stdafx.h" und "stdafx.cpp" eine #include-Anweisung hinzu, um die zur Unterstützung von Steuerelementen erforderlichen ATL-Dateien einzuschließen.
Er änderte Polygon.idl, um Details des neuen Steuerelements einzuschließen.
Er fügte das neue Steuerelement zur Objektzuordnung in Polygon.cpp hinzu.
Jetzt können Sie das Steuerelement erstellen, um es in Aktion zu sehen.
Erstellen und Testen des Steuerelements
So erstellen Sie das Steuerelement und testen es
Klicken Sie im Menü Erstellen auf Polygon erstellen.
Sobald die Erstellung des Steuerelements abgeschlossen ist, klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf PolyCtl.htm und wählen Sie In Browser anzeigen aus. Die HTML-Webseite, die das Steuerelement enthält, wird angezeigt. Eine Seite mit dem Titel "ATL 8.0-Testseite für Objekt PolyCtl" sowie der Text PolyCtl sollten angezeigt werden. Dies ist Ihr Steuerelement.
Hinweis
Wenn Sie beim Abschließen dieses Lernprogramms eine Fehlermeldung erhalten, dass die DLL-Datei nicht erstellt werden kann, schließen Sie die Datei "PolyCtl.htm" und den Testcontainer für ActiveX-Steuerelemente und erstellen Sie die Projektmappe erneut.Wenn Sie die DLL immer noch nicht erstellen können, starten Sie den Computer neu oder melden Sie sich ab (wenn Sie die Terminaldienste verwenden).
Als Nächstes fügen Sie dem Steuerelement eine benutzerdefinierte Eigenschaft hinzu.
Zurück zu Schritt 1 | Weiter zu Schritt 3