COleControlSite::CreateControl

Artikel
02/26/2013

Erstellt ein ActiveX-Steuerelement gehostet, durch das COleControlSite-Objekt.

virtual HRESULT CreateControl(
   CWnd* pWndCtrl,
   REFCLSID clsid,
   LPCTSTR lpszWindowName,
   DWORD dwStyle,
   const RECT& rect,
   UINT nID,
   CFile* pPersist = NULL,
   BOOL bStorage = FALSE,
   BSTR bstrLicKey = NULL 
);
virtual HRESULT CreateControl(
   CWnd* pWndCtrl,
   REFCLSID clsid,
   LPCTSTR lpszWindowName,
   DWORD dwStyle,
   const POINT* ppt,
   const SIZE* psize,
   UINT nID,
   CFile* pPersist = NULL,
   BOOL bStorage = FALSE,
   BSTR bstrLicKey = NULL 
);

Parameter

pWndCtrl
Ein Zeiger auf Fensterobjekt, das das Steuerelement darstellt.
clsid
Die eindeutigen Klassen-ID des Steuerelements.
lpszWindowName
Ein Zeiger auf im Steuerelement angezeigt werden, Text.Legt den Wert der Beschriftungs- oder Texteigenschaft des winodws fest (falls vorhanden).
dwStyle
Windows-Formate.Die verfügbaren Stile werden unter dem Remarks-Abschnitt aufgelistet.
rect
Gibt die Größe und die Position des Steuerelements an.Sie kann ein CRect-Objekt oder eine Struktur RECT sein.
nID
Gibt ID des untergeordneten Fensters des Steuerelements an
pPersist
Ein Zeiger auf CFile, das persistenten Zustand für das Steuerelement enthält.Der Standardwert ist NULL und angibt, dass das Steuerelement auf initialisiert, ohne seinen Zustand von jedem permanenten Speicher wiederherzustellen.Wenn nicht NULL, wird ein Zeiger auf CFile von abgeleitetes Objekt ist, das die persistenten Daten des Steuerelements enthält, entweder in Form eines Streams oder einem Speicher.Diese Daten können in einer vorherigen Aktivierung des Clients gespeichert werden.CFile kann andere Daten enthalten, muss jedoch den Lese-Schreibzeiger zum ersten Byte persistenten Daten zum Zeitpunkt des Aufrufs zu CreateControl verfügen.
bStorage
Gibt an, ob die Daten in pPersist als IStorage oder IStream Daten interpretiert werden sollen.Wenn die Daten in pPersist ein Speicher sind, sollte bStorageTRUE sein.Wenn die Daten in pPersist ein Stream sind, sollte bStorageFALSE sein.Der Standardwert ist FALSE.
bstrLicKey
Optionale Lizenzschlüsseldaten.Diese Daten werden nur für das Erstellen von Steuerelementen erfordert, die einen Ablauflizenzschlüssel erfordern.Wenn das Steuerelement Lizenzierung unterstützt, müssen Sie einen Lizenzschlüssel für die Erstellung des Steuerelements bereitstellen, um folgen.Der Standardwert ist NULL.
ppt
Ein Zeiger auf eine Struktur POINT, die obere linke Ecke des Steuerelements enthält.Die Größe des Steuerelements wird durch den Wert von psize bestimmt.ppt und psize-Werte sind eine optionale Angabe der Größe und Position opf das Steuerelement.
psize
Ein Zeiger auf eine SIZE-Struktur, die die Größe des Steuerelements enthält.Die linke obere Ecke wird durch den Wert von ppt bestimmt.ppt und psize-Werte sind eine optionale Angabe der Größe und Position opf das Steuerelement.

Rückgabewert

Ein HRESULT-Standardwert.

Hinweise

Nur eine Teilmenge der Flags Windows dwStyle werden durch CreateControl unterstützt:

WS_VISIBLE wird ein Fenster erstellt, das zuerst sichtbar ist.Erforderlich, wenn Sie das Steuerelement sofort sichtbar sein soll, wie gewöhnliche Fenster.
WS_DISABLED wird ein Fenster erstellt, das zuerst deaktiviert ist.Ein deaktiviertes Fenster kann Benutzereingaben nicht erhalten.Kann festgelegt werden, wenn das Steuerelement eine aktivierte Eigenschaft verfügt.
WS_BORDER stellt ein Fenster mit einem DünnZeile Rahmen erstellt.Kann festgelegt werden, wenn eine BorderStyle-Eigenschaft Steuerelement verfügt.
WS_GROUP gibt das erste Steuerelement einer Gruppe Steuerelemente an.Der Benutzer kann den Tastaturfokus von einem Steuerelement in der Gruppe wie folgt ändern, indem er die Pfeiltasten verwendet.Alle Steuerelemente, die mit dem WS_GROUP Format nach dem ersten - Steuerelement definiert werden, gehören derselben Gruppe.Das folgende - Steuerelement mit dem WS_GROUP Format beendet die Gruppe und beginnt die folgende Gruppe.
WS_TABSTOP gibt ein Steuerelement, das den Tastaturfokus erhalten kann, wenn der Benutzer die TAB-TASTE drückt.Die TAB-TASTEen-Änderungen der Tastaturfokus am nächsten Steuerelement des WS_TABSTOP Format drücken.