CAxWindow::CreateControlEx
更新 : 2007 年 11 月
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
コントロールを作成するための文字列へのポインタ。次のいずれかの書式にする必要があります。"MSCAL.Calendar.7" などの ProgID。
"{8E27C92B-1264-101C-8A2F-040224009C02}" などの CLSID。
"https://www.microsoft.com/japan" などの URL。
"file://\\Documents\MyDoc.doc" などのアクティブ ドキュメントへの参照。
"MSHTML:<HTML><BODY>This is a line of text</BODY></HTML>" などの HTML コード片。
.gif "メモ")
メモ :HTML フラグメントを MSHTML ストリームとして指定するには、HTML フラグメントの前に "MSHTML:" を付ける必要があります。Windows Mobile プラットフォームでは ProgID と CLSID のみがサポートされています。Windows CE が搭載されたプラットフォーム (CE IE をサポートする Windows Mobile 以外) は、ProgID、CLSID、URL、アクティブなドキュメントへの参照、および HTML の断片など、すべての種類をサポートしています。
pStream
[入力] コントロールのプロパティを初期化するときに使用するストリームへのポインタ。NULL の場合もあります。ppUnkContainer
[出力] コンテナの IUnknown を受け取るポインタのアドレス。NULL の場合もあります。ppUnkControl
[出力] コントロールの IUnknown を受け取るポインタのアドレス。NULL の場合もあります。iidSink
[入力] 包含されたオブジェクトのアウトゴーイング インターフェイスのインターフェイス ID。IID_NULL の場合もあります。punkSink
[入力] iidSink で指定された包含オブジェクトのコネクション ポイントに接続されるシンク オブジェクトの、IUnknown インターフェイスへのポインタ。dwResID
[入力] HTML リソースのリソース ID。WebBrowser コントロールは、指定されたリソースを使用して作成され、読み込まれます。
戻り値
標準の HRESULT 値を返します。
解説
このメソッドは CAxWindow::CreateControl メソッドと似ています。ただし、CreateControlEx では、新規作成されたコントロールへのインターフェイス ポインタを受け取ったり、コントロールが発生させたイベントをイベント シンクが受け取るように設定したりできる点が異なります。
ライセンス付きの ActiveX コントロールの作成、初期化、およびホストについては、「CAxWindow2T::CreateControlLicEx」を参照してください。
使用例
CreateControlEx の使用例については、「ATL AXHost を使用した ActiveX コントロールのホスト」を参照してください。
必要条件
ヘッダー : atlwin.h