COleControlContainer::CreateControl
Vytvoří ovládací prvek ActiveX hostovaných zadaném COleControlSite objektu.
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
Ukazatel okna objekt představující ovládacího prvku.clsid
Jedinečný Identifikátor ovládacího prvku.lpszWindowName
Ukazatel myši na text zobrazený v ovládacím prvku.Nastaví hodnotu vlastnosti ovládacího prvku titulek nebo Text (pokud existuje).Pokud NULL, není změněna vlastnost titulek nebo Text ovládacího prvku.dwStyle
Styly v systému Windows.Dostupné styly jsou uvedeny v seznamu poznámky oddílu.rect
Určuje velikost a umístění ovládacího prvku.Může být buď CRect objektu nebo RECT struktury.nID
Určuje ID ovládacího prvku podřízené okno.pPersist
Ukazatel CFile obsahující trvalý stav ovládacího prvku.Výchozí hodnota je NULL, označující, že ovládací prvek sám inicializuje bez obnovení stavu z jakékoli trvalého úložiště.Není-li NULL, by mělo být ukazatel CFile -odvozené objekt obsahující trvalá data ovládacího prvku ve formuláři proudu nebo úložiště.Tato data by byla uložena do předchozí aktivace klienta. CFile Mohou obsahovat další data, ale musí mít její ukazatel pro čtení i zápis v okamžiku volání nastavena na první bajt trvalých dat CreateControl .bStorage
Označuje, zda data v pPersist by měla být interpretována jako IStorage nebo IStream data.Pokud data v pPersist je úložiště, bStorage by měla být TRUE.Pokud data v pPersist proud, bStorage by měla být FALSE.Výchozí hodnota je FALSE.bstrLicKey
Volitelný licenční klíč data.Tato data je nutné pouze pro vytvoření ovládacích prvků, které vyžadují spuštění licenční klíč.Pokud ovládací prvek podporuje licencí, je třeba zadat licenční klíč pro vytvoření ovládacího prvku úspěšná.Výchozí hodnota je NULL.ppNewSite
Ukazatel na existující web ovládací prvek, který bude hostitelem ovládacího prvku vytváří.Výchozí hodnota je NULL, označující, že nový ovládací prvek Web bude automaticky vytvořena a připojen nový ovládací prvek.ppt
Ukazatel bod strukturu, která obsahuje levý horní roh ovládacího prvku.Velikost ovládacího prvku je určena hodnota psize. ppt a psize hodnoty jsou volitelné metody určení velikosti a umístění ovládacího prvku.psize
Ukazatel velikosti strukturu, která obsahuje velikost ovládacího prvku.Levý horní roh je určena hodnota ppt . ppt a psize hodnoty jsou volitelné metody určení velikosti a umístění ovládacího prvku.
Vrácená hodnota
Nenulová hodnota, pokud je úspěšná. jinak 0.
Poznámky
Pouze podmnožinu Windows dwStyle příznaky jsou podporovány CreateControl :
WS_VISIBLE vytvoří okno, které se zpočátku zobrazí.Chcete-li, aby ovládací prvek viditelný okamžitě, stejně jako běžná windows vyžadováno.
WS_DISABLED vytvoří okno, které původně zakázána.Zakázané okno nemůže přijímat vstup od uživatele.Můžete nastavit, pokud je ovládací prvek má vlastnost povoleno.
WS_BORDERVytvoří okno tenké čáry ohraničení.Lze nastavit vlastnost styl okraje má ovládací prvek.
WS_GROUP Určuje první ovládací prvek skupiny ovládacích prvků.Uživatel může změnit fokusu klávesnice z jednoho ovládacího prvku ve skupině na další pomocí klávesy se šipkami.Všechny prvky, které jsou definovány WS_GROUP styl po první ovládací prvek patří do stejné skupiny.Další ovládací prvek s WS_GROUP styl skupiny končí a začíná další skupiny.
WS_TABSTOP určuje ovládací prvek, který může získat fokus klávesnice, když uživatel stiskne klávesu TAB.Fokusu klávesnice stisknutím klávesy TAB změní na další kontrolu WS_TABSTOP styl.
Vytvořit výchozí velikosti ovládacích prvků pomocí druhého přetížení.
Požadavky
Záhlaví: afxocc.h