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 im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt
Polygon.Zeigen Sie im Kontextmenü auf "Hinzufügen" , und klicken Sie im Untermenü auf "Neues Element ".
Das Dialogfeld Neues Element hinzufügen wird angezeigt. Die verschiedenen Objektkategorien werden in der Struktur links aufgeführt.
Klicken Sie auf den ATL-Ordner .
Wählen Sie in der Liste der Vorlagen auf der rechten Seite DAS ATL-Steuerelement aus. Klicken Sie auf Hinzufügen. Der ATL-Steuerelement-Assistent wird geöffnet, und Sie können das Steuerelement konfigurieren.
Geben Sie als Kurzname ein, und beachten Sie
PolyCtl, dass die anderen Felder automatisch abgeschlossen werden. Klicken Sie noch nicht auf "Fertig stellen ", da Sie einige weitere Änderungen vornehmen müssen.
Die Seite "Namen" des ATL-Steuerelement-Assistenten enthält die folgenden Felder:
| Feld | Inhalte |
|---|---|
| Kurzname | 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. |
| Co | 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. |
Im ATL-Steuerelement-Assistenten müssen mehrere zusätzliche Einstellungen geändert werden.
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 Verbinden ionspunkte. Diese Option erstellt Unterstützung für eine ausgehende Schnittstelle in der IDL-Datei.
Sie können auch Schnittstellen hinzufügen, um die Funktionalität des Steuerelements zu erweitern.
So erweitern Sie die Funktionalität des Steuerelements
Klicken Sie auf "Schnittstellen", um die Seite "Schnittstellen" zu öffnen.
Wählen Sie den Pfeil nach oben aus, und klicken Sie
IProvideClassInfo2darauf, um ihn in die Liste "Unterstützt" zu verschieben.Wählen Sie den Pfeil nach oben aus, und klicken Sie
ISpecifyPropertyPagesdarauf, um ihn in die Liste "Unterstützt" zu verschieben.
Sie können das Steuerelement auch einfügebar machen, was bedeutet, dass es in Anwendungen eingebettet werden kann, die eingebettete Objekte unterstützen, z. B. Excel oder Word.
So machen Sie das Steuerelement einfügbar
Klicken Sie auf "Darstellung", um die Seite "Darstellung" zu öffnen.
Aktivieren Sie das Kontrollkästchen "Einfügebar" .
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 Sie auf "Aktieneigenschaften ", um die Seite "Aktieneigenschaften" zu öffnen.
Scrollen Sie unter "Nicht unterstützt" in der Liste der möglichen Aktieneigenschaften nach unten. Wählen Sie den Pfeil nach oben aus, und klicken Sie
Fill Colordarauf, um ihn in die Liste "Unterstützt" zu verschieben.Klicken Sie auf Fertig stellen.
Wenn der Assistent das Steuerelement erstellt, treten mehrere Codeänderungen und Dateizufügungen auf. Die folgenden Dateien werden 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 nimmt außerdem die folgenden Codeänderungen vor:
Fügt eine
#includeAnweisung zu den vorkompilierten Headerdateien hinzu, um die FÜR die Unterstützung von Steuerelementen erforderlichen ATL-Dateien einzuschließen.Ändert Polygon.idl so, dass Details des neuen Steuerelements enthalten sind.
Fügt 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".
Nachdem das Steuerelement die Erstellung abgeschlossen hat, klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf "PolyCtl.htm", und wählen Sie "Im Browser anzeigen" aus. Die HTML-Webseite, die das Steuerelement enthält, wird angezeigt. Sie sollten eine Seite mit dem Titel "ATL 8.0-Testseite für Objekt PolyCtl" und dem Steuerelement, dem Text PolyCtl, sehen.
Hinweis
Wenn das Steuerelement nicht sichtbar ist, wissen Sie, dass einige Browser Einstellungen anpassen müssen, um ActiveX-Steuerelemente auszuführen. Informationen zum Aktivieren von ActiveX-Steuerelementen finden Sie in der Dokumentation des Browsers.
Hinweis
Wenn Sie in diesem Lernprogramm eine Fehlermeldung erhalten, dass die DLL-Datei nicht erstellt werden kann, schließen Sie die Datei PolyCtl.htm und den ActiveX Control Test-Container, und erstellen Sie die Lösung erneut. Wenn Sie die DLL immer noch nicht erstellen können, starten Sie den Computer neu, oder melden Sie sich ab, wenn Sie Terminaldienste verwenden.
Als Nächstes fügen Sie dem Steuerelement eine benutzerdefinierte Eigenschaft hinzu.
Zurück zu Schritt 1 | Bei Schritt 3