CWnd::CreateControl

BOOL CWnd::CreateControl (LPCTSTR LpszClass, LPCTSTR LpszWindowName, DWORD DwStyleconst RECTamp;RectCWnd *pParentWndUINTnIDCFile *pPersist= NULL, BOOLbStorage= F&ALSE, BSTRbstrLicKey = NULL );

BOOL CWnd::CreateControl (REFCLSID Clsid, LPCTSTR LpszWindowName, DWORD DwStyleconst RECTamp;RectCWnd *pParentWndUINTnIDCFile *pPersist= NULL, BOOLbStorage= F&ALSE, BSTRbstrLicKey = NULL );

Rückgabewert

Ungleich NULL, wenn erfolgreich; andernfalls 0.

Parameter

lpszClass

Diese Zeichenfolge darf den OLE "kurzen Namen" (ProgID) für die Klasse, z. B. "CIRC3.Circ3Ctrl.1 ". Der Name muss mit dem gleichen Namen registriert das Steuerelement übereinstimmen. Alternativ kann die Zeichenfolge die Zeichenfolgenform einer CLSID, enthalten in Klammern ein, z. B. "{9DBAFCCF-592F-101B-85CE-00608CEC297B}" enthalten. In beiden Fällen konvertiert CreateControl die Zeichenfolge in die entsprechenden Klassen-ID.

lpszWindowName

Ein Zeiger auf den Text im Steuerelement angezeigt werden. Legt den Wert der Beschriftung oder der Text-Eigenschaft des Steuerelements (falls vorhanden). Wenn NULL, das Steuerelement die Beschriftung oder Text-Eigenschaft wird nicht geändert.

dwStyle

Stile in Windows. Die verfügbaren Formatvorlagen sind unter Bemerkungen aufgeführt.

rect

Größe und Position des Steuerelements angibt. Es kann entweder ein CRect -Objekt oder eine RECT -Struktur.

pParentWnd

Gibt das Steuerelement des übergeordneten Fensters. Es darf nicht leer sein.

nID

Gibt die ID des Steuerelements.

pPersist

Ein Zeiger auf ein CFile , die den Zustand für das Steuerelement enthält. Der Standardwert ist NULL, darauf hinweist, dass das Steuerelement selbst initialisiert, ohne seine Wiederherstellungsstatus von persistent speichern. Wenn nicht NULL, sollte es ein Zeiger auf ein CFile-abgeleitetes Objekt enthält das Steuerelement persistente Daten, in Form von einem Stream oder einem Speicher. Diese Daten können in eine vorherige Aktivierung des Clients gespeichert wurden. Die CFile kann andere Daten enthalten, jedoch muss die lesen-schreiben-Zeiger festgelegt haben das erste Byte der persistenten Daten zum Zeitpunkt des Aufrufs von CreateControl.

bStorage

Gibt an, ob die Daten in pPersist als IStorage oder IStream Daten interpretiert werden soll. Wenn die Daten in pPersist ein Speicher ist, sollte bStorage zutreffen. Wenn die Daten in pPersist ein Stream ist, sollte bStorage FALSEsein. Der Standardwert ist FALSE.

BstrLicKey

Optionale Lizenz Schlüssel Daten. Diese Daten werden benötigt, nur zum Erstellen von Steuerelementen, die einen Runtime-Lizenz-Schlüssel erfordern. Wenn das Steuerelement Lizenzierung unterstützt, müssen Sie einen Lizenzschlüssel für die Erstellung des Steuerelements erfolgreich bereitstellen. Der Standardwert ist NULL.

clsid

Die einzigartige Klassen-ID des Steuerelements.

Bemerkungen

Verwenden Sie dieser Member-Funktion zum Erstellen eines OLE-Steuerelements, das dargestellt wird in der MFC-Programm durch ein CWnd -Objekt. CreateControl ist eine direkte Analog der Funktion AfxRegisterWndClass , die Fenster einer CWnderstellt. CreateControl erstellt ein OLE-Steuerelement statt eines normalen Fensters.

CreateControl unterstützt nur eine Teilmenge der Windows DwStyle Fahnen:

• WS_VISIBLE&Nbsp;  Erstellt ein Fenster, das anfänglich angezeigt wird. Erforderlich, wenn das Steuerelement sofort, wie gewöhnliche Fenster sichtbar sein soll.
  
  
• WS_DISABLED&Nbsp;  Erstellt ein Fenster, das anfänglich deaktiviert ist. Eine deaktivierte Fenster kann keine Eingaben vom Benutzer empfangen. Kann festgelegt werden, wenn das Steuerelement eine Enabled-Eigenschaft.
  
  
• WS_BORDER&Nbsp;  Erstellt ein Fenster mit eine dünne Rahmenlinie. Kann festgelegt werden, wenn Steuerelement verfügt über eine BorderStyle-Eigenschaft.
  
  
• WS_GROUP&Nbsp;  Gibt das erste Steuerelement eine Gruppe von Steuerelementen. Der Benutzer kann den Tastaturfokus von einem Steuerelement in der Gruppe zum nächsten ändern mithilfe der Richtungstasten. Alle Steuerelemente definiert mit dem WS_GROUP Stil nach dem ersten Steuerelement gehören zur selben Gruppe. Das nächste Steuerelement mit dem WS_GROUP Stil die Gruppe beendet und beginnt die nächste Gruppe.
  
  
• WS_TABSTOP&Nbsp;  Gibt ein Steuerelement, das den Tastaturfokus erhalten kann, wenn der Benutzer die TAB-Taste drückt. Drücken die TAB-Taste ändert den Tastaturfokus auf das nächste Steuerelement WS_TABSTOP Stil.

CWnd Übersicht |nbsp; Member der Klasse | Hierarchiediagramm

Siehe auch&Nbsp;  Im Visual C++ Programmer's Guide: ActiveX-Steuerelement-Themen