CAxWindow::CreateControl
更新 : 2007 年 11 月
ActiveX コントロールを作成して初期化し、指定されたウィンドウでホストします。
HRESULT CreateControl(
LPCOLESTR lpszName,
IStream* pStream = NULL,
IUnknown** ppUnkContainer = NULL
);
HRESULT CreateControl(
DWORD dwResID,
IStream* pStream = NULL,
IUnknown** ppUnkContainer = 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 の場合もあります。dwResID
HTML リソースのリソース ID。WebBrowser コントロールは、指定されたリソースを使用して作成され、読み込まれます。
戻り値
標準の HRESULT 値。
解説
2 番目の形式を使用すると、HTML コントロールが作成され、dwResID で指定されたリソースにバインドされます。
このメソッドの結果は、次の呼び出しの結果と同じです。
AtlAxCreateControlEx(lpszName, hWnd, pStream, NULL, NULL, GUID_NULL, NULL);
ライセンス付きの ActiveX コントロールの作成、初期化、およびホストについては、「CAxWindow2T::CreateControlLic」を参照してください。
使用例
CreateControl の使用例については、「ATL AXHost を使用した ActiveX コントロールのホスト」を参照してください。
必要条件
ヘッダー : atlwin.h