CAxWindow::CreateControlEx

创建一个ActiveX控件,将其初始化,并将其承载于指定的窗口。

HRESULT CreateControlEx(
   LPCOLESTR lpszName,
   IStream* pStream = NULL,
   IUnknown** ppUnkContainer = NULL,
   IUnknown** ppUnkControl = NULL,
   REFIID iidSink = IID_NULL,
   IUnknown* punkSink = NULL 
);
HRESULT CreateControlEx(
   DWORD dwResID,
   IStream* pStream = NULL,
   IUnknown** ppUnkContainer = NULL,
   IUnknown** ppUnkControl = NULL,
   REFIID iidSink = IID_NULL,
   IUnknown* punkSink = NULL 
);

参数

  • lpszName
    用于创建控件的字符串的指针。以下列方式之一必须设置:

    • 一个ProgID (如“MSCAL.Calendar.7”

    • 一个CLSID (“{}” 8E27C92B-1264-101C-8A2F-040224009C02

    • 一个URL (例如“https://www.microsoft.com”

    • 为活动状态的引用文档例如“file:// \ \ documents \ MyDoc.doc”

    • HTML片段如“MSHTML:<HTML><BODY>这是text</BODY></HTML>行”

      说明说明

      “MSHTML: ”必须在HTML片段,以便被指定为MSHTML流。仅ProgID和CLSID在Windows Mobile平台支持。Windows CE嵌入平台,除Windows Mobile之外使用CE IE支持对所有类型包括ProgID,CLSID,URL,引用活动文档和HTML的片段。

  • pStream
    [out]一个指向用于初始化控件的属性的流的指针。可以是 NULL

  • ppUnkContainer
    [out]将接收容器的 IUnknown 指针的地址。可以是 NULL

  • ppUnkControl
    [out]将接收该控件的 IUnknown 指针的地址。可以是 NULL

  • iidSink
    [out]一个输出接口的接口标识符中包含的对象的。可以是 IID_NULL

  • punkSink
    [out]一个指向要连接的接收器对象的 IUnknown 接口的指针到 iidSink指定的包含的对象连接点。

  • dwResID
    [in] HTML资源的ID。webbrowser控件具有指定的资源将创建并填充。

返回值

标准 HRESULT 值。

备注

此方法类似于 CAxWindow::CreateControl,但是,不同该方法,CreateControlEx 还允许您会收到该控件为新创建的控件并将事件接收器接收事件激发的接口指针。

请参见 CAxWindow2T::CreateControlLicEx 创建,初始化,并且承载一个授权的ActiveX控件。

示例

使用 CreateControlEx的示例参见 承载使用ATL AXHost的ActiveX控件

要求

Header: atlwin.h

请参见

参考

CAxWindow选件类

AtlAxCreateControlEx