COleControlContainer::CreateControl
Tworzy formant ActiveX, obsługiwanych przez określony COleControlSite obiektu.
BOOL CreateControl(
CWnd* pWndCtrl,
REFCLSID clsid,
LPCTSTR lpszWindowName,
DWORD dwStyle,
const RECT& rect,
UINT nID,
CFile* pPersist=NULL,
BOOL bStorage=FALSE,
BSTR bstrLicKey=NULL,
COleControlSite** ppNewSite=NULL
);
BOOL 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,
COleControlSite** ppNewSite=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 tekstu formantu (jeśli ma zastosowanie).Jeśli NULL, właściwość formantu podpis lub tekst nie zostaje zmieniony.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.ppNewSite
Wskaźnik do istniejącej witryny formantu, który będzie obsługiwać formantu tworzony.Wartością domyślną jest NULL, wskazując, że nowe witryny kontroli zostanie automatycznie utworzona i dołączona do nowego formantu.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 położenia formantu.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 położenia formantu.
Wartość zwracana
Niezerowa, jeśli kończy się pomyślnie; 0 inaczej.
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.
Przeciążenie drugi służy do tworzenia formantów o rozmiarze domyślnym.
Wymagania
Nagłówek: afxocc.h