COleControlSite::CreateControl

项目
03/01/2013

创建一个ActiveX控件，承载的 COleControlSite 对象。

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

参数

pWndCtrl
为表示控件的窗口对象的指针。
clsid
控件的唯一选件类ID。
lpszWindowName
对于控件将显示文本的指针。设置winodw的声明或文本属性的值（如果有）。
dwStyle
Windows样式。可用样式列表。Remarks 部分。
rect
指定控件的大小和位置。它可以是 CRect 对象或 RECT 结构。
nID
指定控件的MDI子窗口ID.
pPersist
对包含控件的 CFile 的指针持久状态。默认值为 NULL，这表明该控件初始化自身，而无需还原其从任何持久性存储区的状态。如果不是 NULL，则应是指向 CFile-以流或存储的形式，包含控件的持久性数据的派生对象。此数据在客户端以前的启动可能已保存。 CFile 包含其他数据，但是，必须将其读/写指针设置为第一个字节持久性数据在调用时将 CreateControl。
bStorage
指示是否应解释在 pPersist 的数据作为 IStorage 或 IStream 数据。如果在 pPersist 的数据是存储，bStorage 应为 TRUE。如果在 pPersist 的数据是流，bStorage 应为 FALSE。默认值为 FALSE。
bstrLicKey
选项许可证密钥数据。此数据。创建需要运行时许可证密钥的控件仅需要。如果控件支持授权，必须为控件创建提供许可证密钥成功。默认值为 NULL。
ppt
对包含控件的左上角的 POINT 结构的指针。控件的大小取决于值 psize。 ppt 和 psize 值是指定大小可选的方法并确定opf控件。
psize
对包含控件的大小的 SIZE 结构的指针。该左上角取决于 ppt的值。 ppt 和 psize 值是指定大小可选的方法并确定opf控件。

返回值

标准 HRESULT 值。

备注

Windows dwStyle 标志的一个子集由 CreateControl支持:

WS_VISIBLE 创建初始可见的窗口。必需，如果您希望立即控件可见，类似普通的窗口。
WS_DISABLED 创建初始禁用的窗口。一禁用窗口无法接收来自用户的输入。如果控件已启用的属性，可以设置。
WS_BORDER 用细线边框创建一个窗口。如果控件都有一个BorderStyle属性，可以设置。
WS_GROUP 指定一组控件的第一个控件。通过使用方向键，用户在组中从一个控件转换键盘焦点切换到下。所有控件定义与 WS_GROUP 样式在第一个控件后属于同一组。与 WS_GROUP 样式的下一个控件关闭并开始下一组。
WS_TABSTOP 指定可以接收键盘焦点的控件，当用户按tab键时。按tab键转换键盘焦点切换到 WS_TABSTOP 样式的下一个控件。