CComCompositeControl クラス

[アーティクル]
08/09/2011

このクラスには、複合コントロールの実装に必要なメソッドが用意されています。

template <
   class T 
>
class CComCompositeControl :
   public CComControl< T, CAxDialogImpl< T > >

パラメーター

T
CComObjectRoot または CComObjectRootEx の派生クラス、および複合コントロールをサポートするその他のインターフェイスの派生クラス。

解説

CComCompositeControl クラスの派生クラスは ActiveX 複合コントロールの機能を継承します。 CComCompositeControl から派生した ActiveX コントロールは、標準ダイアログボックスがホストします。これらのタイプのコントロールは、ほかのコントロール (ネイティブな Windows コントロールと ActiveX コントロール) をホストできるので複合コントロールと呼ばれます。

CComCompositeControl は、子クラスの列挙型データメンバーを検索して、複合コントロールの作成時に使用するダイアログリソースを識別します。この子クラスのメンバー IDD は、コントロールのウィンドウとして使用されるダイアログリソースのリソース ID に設定されます。次のコードは、CComCompositeControl の派生クラスが、コントロールのウィンドウとして使用されるダイアログリソースを識別するために保持するデータメンバーの例です。

enum { IDD = IDD_MYCOMPOSITE };

注意

複合コントロールは、ウィンドウなしのコントロールを含むこともできますが、常にウィンドウを持つコントロールになります。

CComCompositeControl の派生クラスによって実装されたコントロールには、既定のタブ動作が組み込まれています。コンテナーアプリケーション内でのタブ操作によってコントロールがフォーカスを受け取ると、Tab キーが押されるたびにフォーカスは、複合コントロール内のすべてのコントロールを巡回します。その後、フォーカスは複合コントロールの外側に出て、コンテナーのタブオーダーの次のアイテムに移ります。複合コントロール内のコントロールのタブオーダーは、ダイアログリソースによって決定され、タブオーダーに従ってタブの移動が行われます。

注意

CComCompositeControl を使用してアクセラレータが適正に動作するためには、コントロールの作成時にアクセラレータテーブルを読み込み、アクセラレータのハンドルと個数を IOleControlImpl::GetControlInfo に返し、最後にコントロールの解放時にテーブルを破棄する必要があります。

使用例

// Example for overriding IOleControlImpl::GetControlInfo()
// This example uses the accelerator table from the project resources
// with the identifier IDR_ACCELTABLE
// Define GetControlInfo() in the header of your composite 
// control class as follows:

STDMETHOD(GetControlInfo)(CONTROLINFO* pCI)
{
    // Load the accelerator table from the resource
    pCI->hAccel = LoadAccelerators(_AtlBaseModule.GetResourceInstance(), 
       MAKEINTRESOURCE(IDR_ACCELTABLE));

    if (pCI->hAccel == NULL)
        return E_FAIL;

    // Get the number of accelerators in the table
    pCI->cAccel = (USHORT)CopyAcceleratorTable(pCI->hAccel, NULL, 0);
    // The following is optional if you want your control
    // to process the return and/or escape keys
    // pCI.dwFlags = CTRLINFO_EATS_RETURN | CTRLINFO_EATS_ESCAPE;
    pCI->dwFlags = 0;

    return S_OK;
}