Schritt 2: Hinzufügen eines Steuerelements
In diesem Schritt fügen Sie ein Steuerelement zum Projekt hinzu, es erstellen und testen es auf einer Webseite.
Arbeitsschritte
So fügen Sie ein Objekt zu einem ATL-Projekt hinzufügen
Klicken Sie in der Klassenansicht auf das Polygonprojekt mit der rechten Maustaste.
Zeigen Sie auf Hinzufügen im Kontextmenü auf, und klicken Sie auf Klasse hinzufügen im Untermenü.
Das Dialogfeld Klasse hinzufügen wird angezeigt.Die verschiedenen Objektkategorien werden in der Struktur links aufgeführt.
Klicken Sie auf den Ordner ATL.
Ziehen Sie aus der Liste der Vorlagen auf der rechten Seite, wählen Sie ATL-Steuerelement.Klicken Sie auf Hinzufügen.Der ATL-Steuerelement-Assistent wird geöffnet und das Steuerelement konfigurieren.
Geben Sie PolyCtl als ein Kurzname und beachten Sie, dass die anderen Felder automatisch abgeschlossen werden.Klicken Sie nicht auf Fertig stellen noch, da Sie Änderungen vornehmen müssen.
Die Seite Namen 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 erstellt, um das Steuerelement zu implementieren. |
.h-Datei |
Die Datei erstellt, um die Definition der C++-Klasse zu enthalten. |
.cpp-Datei |
Die Datei, um die Implementierung der C++-Klasse zu enthalten. |
Co-Klasse |
Der Name der Komponentenklasse für dieses Steuerelement. |
Schnittstelle |
Der Name der Schnittstelle, auf der das Steuerelement die benutzerdefinierten Methoden und Eigenschaften implementiert. |
Text [Type] |
Eine Beschreibung für das Steuerelement. |
ProgID |
Der lesbare Name, der verwendet werden kann, um die CLSID des Steuerelements gesucht wird. |
Sie müssen einige zusätzliche Einstellungen im ATL-Steuerelement-Assistenten ausführen.
So fügen Sie Unterstützung für umfangreiche Fehlerinformationen und Verbindungspunkte aktivieren
Optionen auf, um die Seite Optionen zu öffnen.
Wählen Sie das Kontrollkästchen Verbindungspunkte.Dies erstellt Unterstützung für eine Ausgangsschnittstelle in der IDL-Datei.
Sie können das Steuerelement einfügbar auch erstellen, das heißt es in Anwendungen, die eingebettete Objekte unterstützen, wie Excel oder Word eingebettet werden kann.
Um das Steuerelement einfügbar erstellen
Darstellung auf, um die Seite Darstellung zu öffnen.
Wählen Sie das Kontrollkästchen Einfügbar, das standardmäßig deaktiviert ist.
Das Polygon, das durch das Objekt angezeigt wird, verfügt eine ausgefüllte Füllfarbe, deshalb müssen Sie eine Fill Color Vorrateigenschaft hinzufügen.
Um eine Füllfarbe hinzuzufügen vorrätigen Artikel Sie Eigenschaft und erstellen Sie das Steuerelement
Klicken Sie auf BasiseigenschaftenBasiseigenschaften, um die Seite zu öffnen.
Die Nicht unterstützt führen Sie unten die Liste möglicher vordefinierten Eigenschaften aus.Doppelklicken Sie auf Fill Color, um es in die Liste zu verschieben. Unterstützt
Dies schließt die Optionen für das Steuerelement ab.Klicken Sie auf Fertig stellen.
Da der Assistent das Steuerelement erstellt wurde, mehrere Codeänderungen traten und Dateihinzufügungen ein.Die folgenden Dateien erstellt wurden:
Datei |
Description |
|---|---|
PolyCtl.h |
Enthält die meisten der Implementierung der C++-Klasse CPolyCtl. |
PolyCtl.cpp |
Enthält die Reste 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 den neu erstellten Steuerelement enthält. |
Der Assistent kann auch die folgenden Codeänderungen aus:
Es wurde eine #include-Anweisung an den stdafx.h hinzu und stdafx.cpp Web.config-Dateien, um die ATL-Dateien einzuschließen, die für die Unterstützung von Steuerelementen erforderlich sind.
Geändertes Polygon.idl, um die Details des neuen Steuerelements einzuschließen.
Ein das neue Steuerelement zur Objektzuordnung in Polygon.cpp hinzu.
Nun kann das Steuerelement erstellen, um es in Aktion zu sehen.
Erstellen und Testen des Steuerelements
Um das Steuerelement erstellen und testen
Klicken Sie im Menü auf ErstellenPolygon erstellen.
Sobald beendet das Steuerelement erstellen, Explorer mit PolyCtl.htm im Projektmappen-Explorer und ausgewähltes In Browser anzeigen.Die HTML-Webseite, die das Steuerelement enthält, wird angezeigt.Sie sollten eine Seite mit dem Namen "ATL finden 8.0-Testseite für Objekt PolyCtl" und den Text PolyCtl.Dies ist das Steuerelement.
.gif "Hinweis") Hinweis |
|---|
Wenn Sie dieses Lernprogramm, wenn Sie eine Fehlermeldung erhalten, in der 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 ausführen.Wenn Sie die DLL noch nicht erstellen können, laden Sie den Computer neu oder benachrichtigen Sie ab (wenn Sie Terminaldienste verwenden). |
Als Nächstes fügen Sie einer benutzerdefinierten Eigenschaft zum Steuerelement hinzu.
Zurück zu Schritt 1 | Klicken Sie zu Schritt 3