COleControlContainer::CreateControl

创建一个ActiveX控件,承载所指定的 COleControlSite 对象。

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

参数

  • pWndCtrl
    为表示控件的窗口对象的指针。

  • clsid
    控件的唯一选件类ID。

  • lpszWindowName
    对于控件将显示文本的指针。 将控件的声明或文本属性的值(如果有)。 如果未发生更改 NULL、控件的说明或文本属性。

  • dwStyle
    Windows样式。 可用样式列表。Remarks 部分。

  • rect
    指定控件的大小和位置。 它可以是 CRect 对象或 RECT 结构。

  • nID
    指定控件的MDI子窗口ID.

  • pPersist
    对包含控件的 CFile 的指针持久状态。 默认值为 NULL,这表明该控件初始化自身,而无需还原其从任何持久性存储区的状态。 如果不是 NULL,则应是指向 CFile-以流或存储的形式,包含控件的持久性数据的派生对象。 此数据在客户端以前的启动可能已保存。 CFile 包含其他数据,但是,必须将其读/写指针设置为第一个字节持久性数据在调用时将 CreateControl

  • bStorage
    指示是否应解释在 pPersist 的数据作为 IStorageIStream 数据。 如果在 pPersist 的数据是存储,bStorage 应为 TRUE。 如果在 pPersist 的数据是流,bStorage 应为 FALSE。 默认值为 FALSE

  • bstrLicKey
    选项许可证密钥数据。 此数据。创建需要运行时许可证密钥的控件仅需要。 如果控件支持授权,必须为控件创建提供许可证密钥成功。 默认值为 NULL

  • ppNewSite
    为将承载创建的控件的现有控件站点的指针。 默认值为 NULL,指示新控件网站将自动创建并附加到新的控件。

  • ppt
    对包含控件的左上角的 POINT 结构的指针。 控件的大小取决于值 psize。 ppt 和 psize 值是指定大小可选控件的方法和位置。

  • psize
    对包含控件的大小的 SIZE 结构的指针。 该左上角取决于 ppt的值。 ppt 和 psize 值是指定大小可选控件的方法和位置。

返回值

非零,如果成功;否则为0。

备注

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

  • WS_VISIBLE 创建初始可见的窗口。 必需,如果您希望立即控件可见,类似普通的窗口。

  • WS_DISABLED 创建初始禁用的窗口。 一禁用窗口无法接收来自用户的输入。 如果控件已启用的属性,可以设置。

  • WS_BORDER 用细线边框创建一个窗口。 如果控件都有一个BorderStyle属性,可以设置。

  • WS_GROUP 指定一组控件的第一个控件。 通过使用方向键,用户在组中从一个控件转换键盘焦点切换到下。 所有控件定义与 WS_GROUP 样式在第一个控件后属于同一组。 与 WS_GROUP 样式的下一个控件关闭并开始下一组。

  • WS_TABSTOP 指定可以接收键盘焦点的控件,当用户按tab键时。 按tab键转换键盘焦点切换到 WS_TABSTOP 样式的下一个控件。

使用第二个重载创建默认大小。

要求

Header: afxocc.h

请参见

参考

COleControlContainer Class

层次结构图