BOOL CWnd::CreateControl (LPCTSTR lpszClass, LPCTSTR lpszWindowName, DWORD dwStyleStała RECTamp;RectCWnd *,pParentWndUINTnIDCFile *,pPersist= NULL, BOOLbStorage= F&ALSE, BSTRbstrLicKey = NULL );
BOOL CWnd::CreateControl (REFCLSID clsid, LPCTSTR lpszWindowName, DWORD dwStyleStała RECTamp;RectCWnd *,pParentWndUINTnIDCFile *,pPersist= NULL, BOOLbStorage= F&ALSE, BSTRbstrLicKey = NULL );
Wartość zwracany
Niezerowa, jeśli kończy się pomyślnie; inny sposób 0.
Parametry
lpszClass
Ten ciąg może zawierać OLE "krótka nazwa" (ProgID) dla tej klasy, np "CIRC3.Circ3Ctrl.1 ". Nazwa powinna być zgodna taką samą nazwę zarejestrowanego przez formant. Alternatywnie ciąg może zawierać postaci ciągu identyfikatora CLSID, zawarte w nawiasach klamrowych np "{9DBAFCCF-592F-101B-85CE-00608CEC297B}". W każdym z tych przypadków CreateControl konwertuje ciąg znaków do odpowiedniego Identyfikatora klasy.
lpszWindowName
Wskaźnik wyświetlany w formancie tekst. Ustawia wartość właściwości Caption lub tekstu formantu, (jeśli występują). Jeśli wartość NULL, kontroli przez podpis lub właściwości tekst nie zostaje zmieniony.
dwStyle
Style Windows. Dostępne style są wyświetlane w obszarze uwagi.
rect
Określa rozmiar i położenie formantu. Może to być obiektem CRect lub strukturą RECT.
pParentWnd
Określa okno nadrzędne formantu. Nie może być ZEROWY.
nID
Określa identyfikator formantu.
pPersist
Wskaźnik CFile zawierających trwałe Państwo do celów kontroli. Domyślną wartością jest NULL, wskazując, że formant inicjuje się bez przywrócenia stanu z trwałego magazynu. Jeśli nie NULL, należy wskaźnik CFile-pochodnych obiekt, który zawiera trwałe dane z formantu w formularzu strumienia lub magazynowania. Dane te można została zapisana w poprzednich aktywacji klienta. CFile może zawierać inne dane, ale musi mieć jej odczytu zapisu wskaźnik ustawiony na pierwszy bajt trwałe dane w czasie wywołanie CreateControl.
bStorage
Wskazuje, czy dane w pPersist powinny być interpretowane jako dane IStorage lub obiektu IStream. Jeśli dane w pPersist magazynowania, bStorage powinny być prawdziwe. Jeśli dane w pPersist jest strumieniem, bStorage powinny być FAŁSZYWE. Wartością domyślną jest FALSE.
bstrLicKey
Fakultatywne dane klucza licencji. Dane te jest konieczne tylko w przypadku tworzenia formantów, które wymagają klucza licencyjnego run-time. Jeśli formant obsługuje, licencjonowanie, musi dostarczyć klucza licencyjnego dla utworzenia formantu powiodła się. Domyślną wartością jest NULL.
identyfikator clsid
Klasy unikatowy identyfikator formantu.
Uwagi
Członkowskich tej funkcji do utworzenia formantu OLE, który będzie reprezentowany w programie MFC przez obiekt CWnd . CreateControl jest bezpośrednie analogowe funkcję CWnd::Create , która tworzy okno CWnd. CreateControl tworzy formantu OLE zamiast zwykłego okna.
Tylko podzbiór flagi dwStyle systemu Windows są obsługiwane dla CreateControl:
Omówienie CWnd |nbsp; Klasa członków | Wykres hierarchii
Zobacz też W Visual C++ Programmer's Guide: Tematy formantu ActiveX