CAxWindow2T クラス

  • [アーティクル]

このクラスは、ActiveX コントロールをホストするウィンドウを操作するメソッドを提供します。また、ライセンスされた ActiveX コントロールをホストするサポートも備えています。

重要

このクラスとそのメンバーは、Windows ランタイムで実行するアプリケーションで使用することはできません。

構文

template <class TBase = CWindow>
    class CAxWindow2T :
    public CAxWindowT<TBase>

パラメーター

TBase
CAxWindowT の派生クラス。

メンバー

パブリック コンストラクター

名前 説明
CAxWindow2T::CAxWindow2T CAxWindow2T オブジェクトを構築します。

パブリック メソッド

名前 説明
CAxWindow2T::Create ホスト ウィンドウを作成します。
CAxWindow2T::CreateControlLic ライセンスされた ActiveX コントロールを作成して初期化し、指定されたウィンドウでホストします。
CAxWindow2T::CreateControlLicEx ライセンス対象の ActiveX を作成し、それを初期化して、指定したウィンドウ内でホストし、コントロールからインターフェイス ポインターを 1 つ以上取得します。
CAxWindow2T::GetWndClassName ウィンドウ クラスの名前を取得する静的メソッド。

パブリック演算子

名前 説明
CAxWindow2T::operator = 既存の CAxWindow2T オブジェクトに HWND を代入します。

解説

CAxWindow2T は、ActiveX コントロールをホストするウィンドウを操作するメソッドを提供します。 CAxWindow2T では、ライセンスされた ActiveX コントロールのホストティングもサポートされます。 このホスティングは、CAxWindow2T によってラップされる "AtlAxWinLic80" によって提供されます。

クラス CAxWindow2 は CAxWindow2T クラスの特殊化として実装されます。 この特殊化は、次のように宣言されます。

typedef CAxWindow2T <CWindow> CAxWindow2;

Note

CAxWindowT メンバーは、CAxWindow の下に文書化されます。

このクラスのメンバーを使用する例については、「ATL AXHost を使用して ActiveX コントロールをホストする」を参照してください。

継承階層

TBase

CAxWindowT

CAxWindow2T

必要条件

ヘッダー: atlwin.h

CAxWindow2T::CAxWindow2T

CAxWindow2T オブジェクトを構築します。

CAxWindow2T(HWND  hWnd = NULL) : CAxWindowT<TBase>(hWnd)

パラメーター

hWnd
既存のウィンドウのハンドル。

CAxWindow2T::Create

ホスト ウィンドウを作成します。

HWND Create(
    HWND hWndParent,
    _U_RECT rect = NULL,
    LPCTSTR szWindowName = NULL,
    DWORD dwStyle = 0,
    DWORD dwExStyle = 0,
    _U_MENUorID MenuOrID = 0U,
    LPVOID lpCreateParam = NULL);

解説

CAxWindow2T::Create は、LPCTSTR lpstrWndClass パラメーターをコントロール ホスティング (AtlAxWinLic80) を提供するウィンドウクラスに設定して、CWindow::Create を呼び出します。

パラメーターと戻り値の説明については、CWindow::Create を参照してください。

注 0 を MenuOrID パラメーターの値として使用する場合は、コンパイラ エラーを回避するために、0U (既定値) として指定する必要があります。

例

CAxWindow2T::Create を使用する例については、「ATL AXHost を使用して ActiveX コントロールをホストする」を参照してください。

CAxWindow2T::CreateControlLic

ライセンスされた ActiveX コントロールを作成して初期化し、指定されたウィンドウでホストします。

HRESULT CreateControlLic(
    DWORD dwResID,
    IStream* pStream = NULL,
    IUnknown** ppUnkContainer = NULL,
    BSTR bstrLicKey = NULL);

HRESULT CreateControlLic(
    LPCOLESTR lpszName,
    IStream* pStream = NULL,
    IUnknown** ppUnkContainer = NULL,
    BSTR bstrLicKey = NULL);

パラメーター

bstrLicKey
コントロールのライセンス キー。非ライセンス コントロールを作成する場合は NULL。

解説

残りのパラメーターと戻り値の説明については、「CAxWindow::CreateControl」を参照してください。

例

CAxWindow2T::CreateControlLic を使用する例については、「ATL AXHost を使用して ActiveX コントロールをホストする」を参照してください。

CAxWindow2T::CreateControlLicEx

ライセンス対象の ActiveX を作成し、それを初期化して、指定したウィンドウ内でホストし、コントロールからインターフェイス ポインターを 1 つ以上取得します。

HRESULT CreateControlLicEx(
    LPCOLESTR lpszName,
    IStream* pStream = NULL,
    IUnknown** ppUnkContainer = NULL,
    IUnknown** ppUnkControl = NULL,
    REFIID iidSink = IID_NULL,
    IUnknown* punkSink = NULL,
    BSTR bstrLicKey = NULL);

    HRESULT CreateControlLicEx(
    DWORD dwResID,
    IStream* pStream = NULL,
    IUnknown** ppUnkContainer = NULL,
    IUnknown** ppUnkControl = NULL,
    REFIID iidSink = IID_NULL,
    IUnknown* punkSink = NULL,
    BSTR bstrLickey = NULL);

パラメーター

bstrLicKey
コントロールのライセンス キー。非ライセンス コントロールを作成する場合は NULL。

解説

残りのパラメーターと戻り値の説明については、「CAxWindow::CreateControlEx」を参照してください。

例

CAxWindow2T::CreateControlLicEx を使用する例については、「ATL AXHost を使用して ActiveX コントロールをホストする」を参照してください。

CAxWindow2T::GetWndClassName

ウィンドウ クラスの名前を取得します。

static LPCTSTR GetWndClassName();

戻り値

ライセンス付きおよび非ライセンス ActiveX コントロールをホストできるウィンドウ クラス (AtlAxWinLic80) の名前を含む文字列へのポインター。

CAxWindow2T::operator =

既存の CAxWindow2T オブジェクトに HWND を代入します。

CAxWindow2T<TBase>& operator= (HWND hWnd);

パラメーター

hWnd
既存のウィンドウのハンドル。

関連項目

クラスの概要
コントロールコンテインメントに関する FAQ