ATL-Eigenschaftenseiten-Assistent
Aktualisiert: November 2007
Mit diesem Assistenten fügen Sie einem ATL-Projekt eine Eigenschaftenseite hinzu oder versehen ein MFC-Projekt mit ATL-Unterstützung. Durch eine ATL-Eigenschaftenseite wird eine Benutzeroberfläche bereitgestellt, in der Eigenschaften eines oder mehrerer COM-Objekte festgelegt (bzw. Methoden aufgerufen) werden können.
Hinweise
Ab Visual Studio 2008 registriert das von diesem Assistenten erstellte Registrierungsskript seine COM-Komponenten unter HKEY_CURRENT_USER statt unter HKEY_LOCAL_MACHINE. Um dieses Verhalten zu ändern, legen Sie die Option Komponente für alle Benutzer registrieren des ATL-Assistenten fest.
Namen
Geben Sie die Namen für Objekt, Schnittstelle und Klassen an, die dem Projekt hinzugefügt werden sollen. Mit Ausnahme von Kurzer Name können alle weiteren Felder unabhängig voneinander bearbeitet werden. Wenn Sie den Eintrag unter Kurzer Name ändern, wirkt sich die Änderung auf die Namen in allen anderen Feldern auf dieser Seite aus. Wenn Sie den Namen unter Coclass im COM-Abschnitt ändern, wirkt sich die Änderung auf die Felder Typ und Programm-ID aus. Dieses Namenssystem ist so ausgelegt, dass alle Namen während der Entwicklung der Eigenschaftenseite leicht identifizierbar sind.
.gif "Hinweis") Hinweis: |
|---|
Coclass kann nur bei nicht attributierten Projekten bearbeitet werden. Verfügt das Projekt über Attribute, kann Coclass nicht bearbeitet werden. |
C++
Liefert Informationen über die C++-Klasse, die zur Implementierung des Objekts erstellt wurde.
Begriff |
Definition |
Kurzer Name |
Legt den abgekürzten Namen für das Objekt fest. Der hier angegebene Name bestimmt den Klassennamen sowie den unter Coclass angegebenen Namen, die Dateinamen (.cpp und .h), den unter Typ angegebenen Namen sowie die Programm-ID, sofern Sie diese Felder nicht einzeln ändern. |
.h-Datei |
Legt den Namen der Headerdatei für die neue Objektklasse fest. Dieser Name basiert standardmäßig auf dem unter Kurzer Name angegebenen Namen. Klicken Sie auf die Schaltfläche mit den Auslassungspunkten (...), um den Dateinamen am gewünschten Speicherort zu speichern oder um die Klassendeklaration an eine vorhandene Datei anzufügen. Wenn Sie eine vorhandene Datei auswählen, wird sie vom Assistenten erst am ausgewählten Speicherort gespeichert, nachdem Sie im Assistenten auf Fertig stellen geklickt haben. Der Assistent ist nicht in der Lage, Dateien zu überschreiben. Wenn Sie den Namen einer vorhandenen Datei auswählen und dann auf Fertig stellen klicken, wird vom Assistenten eine Bestätigung angefordert, die Klassendeklaration an den Inhalt der Datei anzufügen. Klicken Sie auf Ja, um die Datei anzufügen, und klicken Sie auf Nein, um zum Assistenten zurückzukehren und einen anderen Dateinamen anzugeben. |
Klasse |
Legt den Namen der Klasse fest, durch die das Objekt implementiert wird. Dieser Name basiert auf dem unter Kurzer Name angegebenen Namen. Allerdings wird der Buchstabe C als typisches Präfix für einen Klassennamen vorangestellt. |
.cpp-Datei |
Legt für die neue Objektklasse den Namen der Implementierungsdatei fest. Dieser Name basiert standardmäßig auf dem unter Kurzer Name angegebenen Namen. Klicken Sie auf die Schaltfläche mit den Auslassungspunkten (...), um den Dateinamen am gewünschten Speicherort zu speichern. Die Datei wird erst am ausgewählten Speicherort gespeichert, wenn Sie im Assistenten auf Fertig stellen klicken. Der Assistent ist nicht in der Lage, Dateien zu überschreiben. Wenn Sie den Namen einer vorhandenen Datei auswählen und dann auf Fertig stellen klicken, werden Sie vom Assistenten gefragt, ob die Klassenimplementierung an den Inhalt der Datei angefügt werden soll. Klicken Sie auf Ja, um die Datei anzufügen, und klicken Sie auf Nein, um zum Assistenten zurückzukehren und einen anderen Dateinamen anzugeben. |
Attributiert |
Gibt an, ob das Objekt Attribute verwendet. Wenn Sie einem attributierten ATL-Projekt ein Objekt hinzufügen, ist diese Option aktiviert und kann nicht geändert werden. Sie können attributierte Objekte also nur Projekten hinzufügen, die mit Attributunterstützung erstellt wurden. Ein attributiertes Objekt kann lediglich einem ATL-Projekt hinzugefügt werden, das Attribute verwendet. Wenn Sie diese Option für ein ATL-Projekt auswählen, das nicht über Attributunterstützung verfügt, werden Sie vom Assistenten gefragt, ob dem Projekt Attributunterstützung hinzugefügt werden soll. Alle Objekte, die nach Auswahl dieser Option hinzugefügt wurden, werden automatisch als attributiert konfiguriert (das Kontrollkästchen ist aktiviert). Sie können das Kontrollkästchen deaktivieren, um ein Objekt hinzuzufügen, das keine Attribute verwendet. Weitere Informationen finden Sie unter Anwendungseinstellungen, ATL-Projekt-Assistent und Grundlegende Funktionsweise von Attributen. |
COM
Bietet Informationen über die COM-Funktionen des Objekts.
Coclass
Legt den Namen der Komponentenklasse fest. Sie enthält eine Liste der vom Objekt unterstützten Schnittstellen.Hinweis:Wenn Sie das Projekt unter Verwendung von Attributen erstellen oder auf dieser Seite des Assistenten angeben, dass die Eigenschaftenseite Attribute verwendet, können Sie diese Option nicht ändern, da das coclass-Attribut nicht in ATL enthalten ist.
Typ
Legt die in der Registrierung verwendete Objektbeschreibung fest.Programm-ID
Legt den Namen fest, den Container anstelle der CLSID des Objekts verwenden können.
Siehe auch
Konzepte
Example: Implementing a Property Page