MFC-Klassen-Assistent

Aktualisiert: November 2007

Mit diesem Code-Assistenten fügen Sie einem vorhandenen MFC-Projekt oder einem ATL-Projekt mit integrierter MFC-Unterstützung eine Klasse hinzu. Außerdem können Sie Win32-Projekten, die über MFC-Unterstützung verfügen, MFC-Klassen hinzufügen. Es hängt von den beim Erstellen des Projekts festgelegten Features ab, welche Optionen in diesem Dialogfeld verfügbar sind.

Hinweis:

Wenn Sie diesen Assistenten mit einem Geräteprojekt verwenden, informieren Sie sich unter Nicht unterstützte Assistentenoptionen für den MFC-Klassen-Assistenten.

Namen

Geben Sie auf dieser Seite den Klassennamen, die Basisklasse und die Dateinamen für die neue Klasse an.

  • Klassenname
    Legt den Namen der neuen Klasse fest und gibt die Standardbasis für die Namen von IDs und Dateien auf dieser Seite vor. C++-Klassen beginnen normalerweise mit dem Buchstaben "C". CMeineKlasse wird beispielsweise zu MeineKlasse.h usw.

  • Basisklasse
    Gibt den Namen der Basisklasse für die neue Klasse an. Die Basisklasse entspricht standardmäßig CWnd. Durch die ausgewählte Basisklasse wird festgelegt, welche Felder auf dieser Seite aktiviert sind.

    Der Typ der als Basisklasse festlegten Klasse bestimmt, ob die Klasse über eine Dialogfeld-ID oder eine Ressourcen-ID verfügt. Im Folgenden sind die allgemeinen Klassentypen aufgeführt:

    • Klassen, wie CButton, CWnd oder CDocument, für die keine Dialogfeld-ID oder Ressourcen-ID erforderlich ist. Diese Klassen verwenden keine Dialogfeld- oder Ressourcen-ID. Wenn Sie eine dieser Klassen als Basisklasse auswählen, sind die Felder Dialogfeld-ID und DHTML-Ressourcen-ID abgeblendet.

    • Klassen, wie CDialog, CFormView oder CPropertyPage, für die eine Dialogfeld-ID erforderlich ist.

    • Die CDHtmlDialog-Klasse, für die eine Dialogfeld-ID, eine DHTML-Ressourcen-ID und ein HTML-Dateiname erforderlich sind.

    Bei Klassen, die eine Dialogfeld-ID erfordern, ist es u. U. effizienter, die Dialogressource mit dem Ressourcen-Editor zu erstellen, ihre ID im Eigenschaftenfenster zuzuweisen und anschließend eine mit dieser Ressourcen-ID verknüpfte Klasse zu erstellen. Weitere Informationen zum Erstellen eines Windows-Standarddialogfelds finden Sie unter Erstellen eines neuen Dialogfelds.

    Wenn Sie die Klasse zuerst erstellen, können Sie sie später im Eigenschaftenfenster mit der Ressource verknüpfen.

    Hinweis:

    Wenn Sie zuerst eine Dialogressource erstellen und deren neue Klasse von CDHtmlDialog ableiten, löschen Sie die Windows-Standardschaltflächen OK und Abbrechen, die im Standarddialogfeld angezeigt werden. Das Windows-Standarddialogfeld enthält das DHTML-Formular, das über eigene Schaltflächen OK und Abbrechen verfügt.

    Zwar kann das Dialogfeld sowohl Windows- als auch DHTML-Steuerelemente umfassen, von dieser Vorgehensweise wird jedoch abgeraten.

  • Dialogfeld-ID
    Legt die ID des Dialogfelds fest, wenn Sie CDialog, CFormView, CPropertyPage oder CDHtmlDialog als Basisklasse ausgewählt haben.

  • .h-Datei
    Legt den Namen der Headerdatei für die neue Objektklasse fest. Dieser Name basiert standardmäßig auf dem Namen, den Sie unter Klassenname angeben. 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.

  • .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.

  • Active Accessibility
    Aktiviert MFC-Unterstützung für aktive Eingabehilfen, indem EnableActiveAccessibility im Konstruktor aufgerufen wird. Diese Option ist für Klassen verfügbar, die von CWnd abgeleitet sind.

  • DHTML-Ressourcen-ID
    Nur für Klassen, die von CDHtmlDialog abgeleitet sind. Legt die Ressourcen-ID des DHTML-Dialogfelds fest. Die Ressourcen-ID wird im HTML-Abschnitt der projektspezifischen RC-Datei zusammen mit dem Dateinamen des HTML-Dialogfelds angezeigt. Die durch diese ID identifizierte DHTML-Ressource befindet sich in dem Dialogfeld, auf das durch Dialogfeld-ID verwiesen wird.

  • .HTM-Datei
    Nur für Klassen, die von CDHtmlDialog abgeleitet sind. Legt den Namen der HTML-Datei für das DHTML-Dialogfeld fest. Dieser Dateiname basiert standardmäßig auf dem Klassennamen. Der Dateiname wird im HTML-Abschnitt der projektspezifischen RC-Datei zusammen mit der Ressourcen-ID des DHTML-Dialogfelds angezeigt.

  • Automatisierung
    Legt die Klassenebene für die Automatisierungsunterstützung fest. Die Automatisierung auf Klassenebene ist für alle Klassen verfügbar, die die Automatisierung unterstützen. Sie ist auch für Projekte verfügbar, die mit Automatisierungsunterstützung erstellt wurden (z. B. ein MFC-Projekt mit ATL-Unterstützung oder ein MFC-Projekt, für das das Kontrollkästchen Automatisierung auf der Seite Erweiterte Features des MFC-Anwendungs-Assistenten aktiviert wurde.)

    Option

    Beschreibung

    Keine

    Gibt an, dass die Klasse keine Automatisierung unterstützt.

    Automatisierung

    Gibt an, dass die Klasse die Automatisierung unterstützt. Wenn Sie diese Option aktivieren, steht die neu angelegte Klasse als programmierbares Objekt für Automatisierungsclientanwendungen, wie Microsoft Visual Basic und Microsoft Excel, zur Verfügung. Diese Option ist für die Basisklassen, die im Anschluss an diese Tabelle aufgeführt sind, nicht verfügbar.

    Anhand von Typen-ID erstellbar

    Gibt an, dass sowohl die Klasse als auch das Projekt andere Anwendungen unterstützen, die mittels Automatisierung Objekte dieser Klasse erstellen. Mit dieser Option können Automatisierungsclients ein Automatisierungsobjekt direkt erstellen. Die Typ-ID im Textfeld wird von der Clientanwendung genutzt, um das zu erstellende Objekt anzugeben. Diese ID gilt systemweit und muss eindeutig sein. Diese Option ist für die Basisklassen, die im Anschluss an diese Tabelle aufgeführt sind, nicht verfügbar.

    Für die folgenden Basisklassen ist die Automatisierungsunterstützung nicht verfügbar:

    • CAsyncMonitorFile

    • CAsyncSocket

    • CCachedDataPathProperty

    • CConnectionPoint

    • CDatabase

    • CDataPathProperty

    • CHttpFilter

    • CHttpServer

    • CInternetSession

    • CObject

    • CSocket

  • Typ-ID
    Legt die Typ-ID der Klasse fest. Im Feld Typ-ID werden der Projektname und der neue Klassenname wie folgt verkettet: MFCProj.MFCClass. Diese ID kann nur geändert werden, wenn unter Automatisierung die Option Anhand von Typen-ID erstellbar aktiviert wurde.

  • Erstellte DocTemplate-Ressourcen
    Gibt an, dass die von der Anwendung erstellten Dokumente über Ressourcen für Dokumentvorlagen verfügen. Damit dieses Kontrollkästchen aktiviert werden kann, muss das Projekt die MFC-Dokument-/Ansichtarchitektur unterstützen, und die Basisklasse dieser Klasse muss CFormView entsprechen.

    Weitere Informationen finden Sie unter Dokumentvorlagen und der Erstellungsvorgang für Dokument und Ansicht.

Siehe auch

Aufgaben

Hinzufügen einer MFC-Klasse

Konzepte

Hinzufügen einer Klasse