Exemplarische Vorgehensweise: Erstellen eines ATL-ActiveX-Steuerelements für intelligente Geräte und mehrere Plattformen

Aktualisiert: November 2007

Sie können Visual C++ für Geräte verwenden, um ActiveX-Steuerelemente für mehrere Geräte zu erstellen. In der folgenden exemplarischen Vorgehensweise wird die Erstellung eines ATL-ActiveX-Steuerelements für mehrere Plattformen veranschaulicht.

In dieser exemplarischen Vorgehensweise führen Sie diese Hauptaufgaben aus:

• Erstellen eines ATL-Projekts für intelligente Geräte und mehrere Plattformen

• Hinzufügen eines ActiveX-Steuerelements zum Projekt mithilfe des Assistenten. Der größte Teil der grundlegenden Struktur und des Codes wird vom Assistenten generiert.

• Bearbeiten Sie den Code in der Datei stdafx.h und der Datei samplecontrol.h, um das Threadmodell zu definieren und Compilerwarnungen zu vermeiden.

• Bereitstellen der Projektmappe für mehrere Plattformen Es wird auch eine Internet Explorer-Datei generiert, um das Testen und Ausführen des Steuerelements zu vereinfachen.

Diese exemplarische Vorgehensweise wurde mithilfe von Visual C++-Entwicklungseinstellungen geschrieben.

Hinweis:
Je nach den aktiven Einstellungen oder der Version unterscheiden sich die Dialogfelder und Menübefehle auf Ihrem Bildschirm möglicherweise von den in der Hilfe beschriebenen. Sie können die Einstellungen ändern, indem Sie im Menü Extras auf Einstellungen importieren und exportieren klicken. Weitere Informationen hierzu finden Sie unter Visual Studio-Einstellungen.

Erstellen eines ATL-ActiveX-Steuerelements für mehrere Plattformen

So erstellen Sie ein ATL-ActiveX-Steuerelement für mehrere Plattformen

1. Zeigen Sie im Menü Datei auf Neu, klicken Sie auf Projekt, erweitern Sie im Bereich Projekttypen den Knoten Visual C++, und klicken Sie dann auf Intelligentes Gerät.

2. Klicken Sie im Bereich Vorlagen auf ATL-Projekt für intelligente Geräte.

3. Geben Sie ATLAXControl in das Feld Name ein, und klicken Sie dann auf OK.

   Der ATL-Projekt-Assistent für intelligente Geräte wird gestartet.

4. Klicken Sie auf der Willkommensseite des ATL-Projekt-Assistenten für intelligente Geräte auf Weiter.

   Der Plattformen, ATL-Projekt-Assistent für intelligente Geräte wird angezeigt, sodass Sie die Platform SDKs auswählen können, die dem aktuellen Projekt hinzugefügt werden sollen.

5. Wählen Sie in der Liste Installierte SDKs die Plattformen aus, die Sie dem aktuellen Projekt hinzufügen möchten, z. B. Smartphone 2003 oder Pocket PC 2003. Um eine Plattform hinzuzufügen, wählen Sie im linken Bereich die Plattform aus, z. B. Smartphone 2003, und klicken dann auf die Schaltfläche mit dem nach rechts weisenden Pfeil (>). Um eine Plattform zu entfernen, wählen Sie im rechten Bereich die Plattform aus, z. B. Pocket PC 2003, und klicken dann auf die Schaltfläche mit dem nach links weisenden Pfeil (<).

6. Klicken Sie auf Fertig stellen, um den Assistenten zu beenden und zu schließen.

Hinzufügen eines ActiveX-Steuerelements zum Projekt

So fügen Sie dem Projekt ein ActiveX-Steuerelement hinzu

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf ATLAXControl, zeigen Sie auf Hinzufügen, und klicken Sie dann auf Klasse.

2. Klicken Sie im Bereich Kategorien auf Intelligentes Gerät.

3. Klicken Sie im Bereich Vorlagen auf ATL-Steuerelement, und klicken Sie dann auf Hinzufügen.

   Das Dialogfeld ATL-Steuerelement-Assistent wird angezeigt.

4. Geben Sie im Textfeld Kurzer Name den Namen samplecontrol ein.

5. Klicken Sie auf Fertig stellen, um den Assistenten zu beenden und zu schließen.

Ändern des Codes in Headerdateien

So ändern Sie den Code in der Datei stdafx.h

1. Doppelklicken Sie im Projektmappen-Explorer auf die Datei stdafx.h, um sie im Editor zu öffnen.

2. Fügen Sie die Definition #define _CE_ALLOW_SINGLE_THREADED_OBJECTS_IN_MTA nach #pragma once ein, wie hier dargestellt:

       // Add this define after 
       #pragma once
   #define _CE_ALLOW_SINGLE_THREADED_OBJECTS_IN_MTA
   

3. Fügen Sie dem Projekt ein ActiveX-Steuerelement hinzu, wie in der folgenden Prozedur beschrieben.

So fügen Sie dem Projekt ein ActiveX-Steuerelement hinzu

1. Doppelklicken Sie im Projektmappen-Explorer auf die Datei samplecontrol.h, um sie im Editor zu öffnen.

2. Ersetzen Sie in der Codedefiniton Isamplecontrol die Zeichenfolge ATL 8.0 : samplecontrol durch Hello World ActiveX Control.

Hinweis:

ActiveX-Steuerelementen für eine DCOM-Plattform sollte bei der Erstellung das Threadingmodell "Apartment-threaded" zugeordnet werden. Dies ist die Standardeinstellung des ATL-Steuerelement-Assistenten. Die während des Kompilierens generierte Warnung können Sie einfach ignorieren. Auch in ATL-, GUI- und EXE-Projekten, in denen Sie z. B. atlwin.h, atlctl.h oder atlhost.h einem ATL-EXE-Projekt hinzugefügt haben, sollte in der Datei stdafx.h _CE_ALLOW_SINGLE_THREADED_OBJECTS_IN_MTA definiert werden, bevor die ATL-Headerdateien eingebunden werden. Diese Vorgehensweise ist beim Entwickeln für den Desktop identisch. Weitere Informationen finden Sie unter Erstellen und Debuggen von Visual C++-Geräteprojekten.

Bereitstellen der ATL-Projektmappe für mehrere Plattformen

So stellen Sie die Projektmappe bereit

1. Klicken Sie im Menü Erstellen auf Projektmappe neu erstellen, um das Steuerelement zu erstellen.

2. Klicken Sie im Menü Erstellen auf Projektmappe bereitstellen.

3. Wählen Sie auf der Visual Studio-Symbolleiste in der Dropdownliste Zielgerät das Zielgerät aus, z. B. Pocket PC 2003 SE-Emulator oder Pocket PC 2003-Gerät.

4. Klicken Sie im Menü Erstellen auf Bereitstellen.

Auswählen eines Zielgeräts

Um sicherzustellen, dass Sie beim Bereitstellen der Projektmappe eine Eingabeaufforderung für ein Zielgerät erhalten, führen Sie die folgenden Schritte durch.

So legen Sie fest, dass beim Bereitstellen ein Gerät ausgewählt werden kann

1. Klicken Sie im Menü Extras auf Optionen, erweitern Sie den Knoten Gerätetools, und klicken Sie dann auf Allgemein.

2. Wenn Gerätetools nicht sichtbar ist, wählen Sie unten im Dialogfeld Optionen die Option Alle Einstellungen anzeigen.

3. Aktivieren Sie das Kontrollkästchen Vor Bereitstellung von Geräteprojekten Geräteauswahl anzeigen, und klicken Sie dann auf OK.

Um das Steuerelement auszuführen, verwenden Sie den Datei-Explorer auf dem Gerät. Wechseln Sie zu Programme\ATLAXControl, und doppelklicken Sie auf die Internet Explorer-Datei ATLAXControl. Eine oder mehrere Sicherheitsmeldungen werden angezeigt. Klicken Sie auf Ja, um die Seite auszuführen.

Siehe auch

Referenz

Visual C++ (Vorgehensweise für intelligente Geräte)

Weitere Ressourcen

Gewusst wie: Erstellen eines Geräteprojekts für mehrere Plattformen (Visual C++)