COleControlSite::CreateControl

Artykuł
06/10/2015

Tworzy formant ActiveX, obsługiwanych przez COleControlSite obiektu.

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  
);

Parametry

pWndCtrl
Wskaźnik do obiektu okna reprezentującego formantu.
clsid
Klasa unikatowy identyfikator formantu.
lpszWindowName
Wskaźnik tekst wyświetlany w formancie.Ustawia wartość właściwości podpisu lub tekst winodw (jeśli ma zastosowanie).
dwStyle
Style Windows.Dostępne style są wymienione w uwagi sekcji.
rect
Określa rozmiar i położenie formantu.Mogą być albo CRect obiektu lub RECT struktury.
nID
Określa identyfikator formantu podrzędne okna.
pPersist
Wskaźnik do CFile zawierających trwały stan formantu.Wartością domyślną jest NULL, wskazując, że formant inicjuje sama bez przywrócenia stanu z dowolnego trwałego magazynu.Jeśli nie NULL, powinno być wskaźnik do CFile-uzyskane obiektu zawierającego trwałe dane z formantu w formularzu strumienia lub magazynowania.Dane można zapisane w poprzednim aktywacji klienta.CFile Może zawierać inne dane, ale musi mieć wskaźnik jego odczytu i zapisu, ustaw pierwszy bajt danych trwałych w momencie wywołania CreateControl.
bStorage
Wskazuje, czy dane w pPersist powinno być interpretowane jako IStorage lub IStream danych.Jeśli dane w pPersist jest magazyn, bStorage powinien być TRUE.Jeśli dane w pPersist jest strumień, bStorage powinien być FALSE.Wartością domyślną jest FALSE.
bstrLicKey
Opcjonalne dane klucza licencji.Dane potrzebne jest tylko w przypadku tworzenia formantów, które wymagają klucza licencji run-time.Jeśli formant obsługuje licencjonowania, należy podać klucz licencji dla utworzenia formantu powiodła się.Wartością domyślną jest NULL.
ppt
Wskaźnik do punkt strukturę, która zawiera w lewym górnym rogu formantu.Rozmiar formantu jest określony przez wartość psize.ppt i psize wartości są opcjonalne metodę określania rozmiaru i pozycji opf kontroli.
pSize
Wskaźnik do rozmiar strukturę, która zawiera rozmiar formantu.Lewy górny róg jest określana wartość ppt.ppt i psize wartości są opcjonalne metodę określania rozmiaru i pozycji opf kontroli.

Wartość zwracana

Standard HRESULT wartości.

Uwagi

Podzbiór Windows dwStyle flagi są obsługiwane przez CreateControl:

WS_VISIBLE tworzy okno początkowo widoczny.Wymagane, jeśli widoczne natychmiast, jak zwykłe okna formantu.
WS_DISABLED tworzy okno, która początkowo jest wyłączona.Wyłączone okno nie mogą odbierać danych wejściowych od użytkownika.Można ustawić, jeśli formant ma właściwość Enabled.
WS_BORDERTworzy okno z obramowaniem cienki linii.Można ustawić, jeśli formant ma Właociwooć BorderStyle.
WS_GROUP Określa pierwszy formant grupy formantów.Użytkownik może zmienić fokus klawiatury z jednego formantu w grupie do następnego przy użyciu klawiszy kierunkowych.Wszystkie formanty zdefiniowana z WS_GROUP styl po pierwszej kontroli należą do tej samej grupy.Następny formant z WS_GROUP styl kończy grupy i rozpoczyna następną grupę.
WS_TABSTOP Określa formant może otrzymać fokus klawiatury, gdy użytkownik naciśnie klawisz TAB.Naciśnięcie klawisza TAB zmienia fokusu klawiatury do następnego formantu z WS_TABSTOP styl.