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 的数据作为 IStorage 或 IStream 数据。 如果在 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