CAxWindow::CreateControl

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

HRESULT CreateControl(
   LPCOLESTR lpszName,
   IStream* pStream = NULL,
   IUnknown** ppUnkContainer = NULL 
);
HRESULT CreateControl(
   DWORD dwResID,
   IStream* pStream = NULL,
   IUnknown** ppUnkContainer = 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>这是一行文本</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

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

返回值

标准 HRESULT 值。

备注

如果使用此方法的第二个版本,HTML控件即被创建并绑定到 dwResID标识的资源。

此方法提供了结果和调用相同:

AtlAxCreateControlEx(lpszName, hWnd, pStream, NULL, NULL, GUID_NULL, NULL);

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

示例

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

要求

Header: atlwin.h

请参见

参考

CAxWindow选件类

AtlAxCreateControl