CWnd::CreateControl

Článek
03/04/2013

Pomocí této funkce členů vytvořit ovládací prvek ActiveX, které budou zastoupeny v programu MFC CWnd objektu.

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

Parametry

pszClass
Tento řetězec může obsahovat "krátký název" OLE (ProgID) třídy, e.g., "CIRC3.Circ3Ctrl.1 ".Název musí odpovídat stejným názvem registrovaných ovládacího prvku.Také řetězec může obsahovat řetězec formě CLSID, obsažené ve složených závorkách, e.g., "{9DBAFCCF-592F-101B-85CE-00608CEC297B}".V obou případech CreateControl převede řetězec na odpovídající ID třídy.
pszWindowName
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 části poznámky.
rect
Určuje velikost a umístění ovládacího prvku.Může být buď CRect objektu nebo RECT struktury.
ppt
Odkazuje bod struktury nebo CPoint objekt, který obsahuje v levém horním rohu ovládacího prvku.
pSize
Odkazuje velikosti struktury nebo CSize objekt, který obsahuje velikost ovládacího prvku
pParentWnd
Určuje nadřazené okno ovládacího prvku.Nesmí být NULL.
nID
Určuje ID ovládacího prvku.
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, který obsahuje 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 data IStorage nebo IStream.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.
clsid
Jedinečný Identifikátor ovládacího prvku.

Vrácená hodnota

Nenulová hodnota, pokud je úspěšná. jinak 0.

Poznámky

CreateControlje přímé analogový z CWnd::Create funkci, která vytvoří okno pro CWnd .CreateControlvytvoří ovládací prvek ActiveX místo běžného okna.

Pouze podmnožinu Windows dwStyle příznaky jsou podporovány pro 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.

Příklad

class CGenocx : public CWnd
{
protected:
   DECLARE_DYNCREATE(CGenocx)
public:
   CLSID const& GetClsid()
   {
      static CLSID const clsid
         = { 0x20DD1B9E, 0x87C4, 0x11D1, { 0x8B, 0xE3, 0x0, 0x0, 0xF8, 0x75, 0x4D, 0xA1 } };
      return clsid;
   }

   // This code is generated by the Control Wizard.
   // It wraps the call to CreateControl in the call to Create.
   virtual BOOL Create(LPCTSTR lpszClassName, LPCTSTR lpszWindowName, DWORD dwStyle,
                  const RECT& rect, CWnd* pParentWnd, UINT nID, 
                  CCreateContext* pContext = NULL)
   { 
      UNREFERENCED_PARAMETER(pContext);
      UNREFERENCED_PARAMETER(lpszClassName);

      return CreateControl(GetClsid(), lpszWindowName, dwStyle, rect, pParentWnd, nID); 
   }

   // remainder of class declaration omitted...

Požadavky

Záhlaví: afxwin.h

Viz také

Referenční dokumentace

Třída CWnd

Diagram hierarchie

Koncepty

Ovládací prvky MFC ActiveX

Sdílet prostřednictvím