Hinzufügen eines Steuerelements (ATL-Lernprogramm, Teil 2)

Artikel
10/12/2023

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 IProvideClassInfo2 darauf, um ihn in die Liste "Unterstützt" zu verschieben.
Wählen Sie den Pfeil nach oben aus, und klicken Sie ISpecifyPropertyPages darauf, 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 Color darauf, 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 #include Anweisung 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

Siehe auch

Tutorial