CConnectionPoint クラス

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

他の OLE オブジェクトと通信するために使われる "コネクションポイント" と呼ばれる特別な型のインターフェイスを定義します。

class CConnectionPoint : public CCmdTarget

解説

OLE コントロールの機能を実装し、公開するために使われる通常の OLE インターフェイスとは異なり、コネクションポイント、イベントや変更通知の起動など、ほかのオブジェクトに対するアクションを実行できるアウトゴーイングインターフェイスを実装します。

接続では、2 つの部分で構成されます。「ソース」と、インターフェイスを実装するオブジェクトと呼ばれるインターフェイスを呼び出すオブジェクトは、「シンク」と呼ばれるコネクションポイントを公開すると、ソースとシンクの接続が確立できます。コネクションポイント機構を使って、ソースオブジェクトはシンクの一連のメンバー関数へのポインターを取得します。たとえば、シンクが実装しているイベントを発生させるには、ソースはシンク実装の適切なメソッドを呼び出します。

既定では、COleControl-派生クラスには、2 つの接続ポイントを実装しています。イベントとプロパティ変更通知。一方の接続でイベントを発生させ、もう一方の接続でプロパティの値の変更をシンク (コントロールのコンテナーなど) に通知します。また、OLE コントロール用にさらにコネクションポイントを用意することもできます。コントロールクラスに実装する追加コネクションポイントごとに、"接続部" を宣言する必要があります。接続部がコネクションポイントを実装します。 1 つ以上のコネクションポイントを実装するときは、コントロールクラスごとに 1 つの "接続マップ" も宣言する必要があります。

簡単なコネクションマップと 1 つの接続ポイントを次の例を示します、Sampleのコードの 2 つの断片で構成される、OLE コントロール。最初の部分には、コネクションマップとポイントを宣言; 2 番目には、このマップとポイントを実装します。プログラムの前半はコントロールクラスの宣言中の protected セクションの下に挿入されます。

// Connection point for ISample interface
 BEGIN_CONNECTION_PART(CMyClass, SampleConnPt)
     CONNECTION_IID(IID_ISampleSink)
 END_CONNECTION_PART(SampleConnPt)

 DECLARE_CONNECTION_MAP()

BEGIN_CONNECTION_PART マクロと END_CONNECTION_PART マクロは、埋め込みクラス XSampleConnPt (CConnectionPoint の派生クラス) を宣言します。この埋め込みクラスは、この特定のコネクションポイントを実装します。 CConnectionPoint メンバー関数をオーバーライドするか、独自のメンバー関数を追加するには、この 2 つのマクロの間に宣言を挿入します。たとえば、この 2 つのマクロ間に CONNECTION_IID を挿入すると、CConnectionPoint::GetIID メンバー関数がオーバーライドされます。

プログラムの後半はコントロールクラスの実装ファイル (.CPP) に挿入されます。後半部分は接続マップを実装しています。この部分では、追加するコネクションポイント SampleConnPt を組み込みます。

BEGIN_CONNECTION_MAP(CMyClass, CCmdTarget)
    CONNECTION_PART(CMyClass, IID_ISampleSink, SampleConnPt)
END_CONNECTION_MAP()

この 2 つのプログラムを挿入すると、Sample OLE コントロールは ISampleSink インターフェイス用のコネクションポイントを公開します。

通常、コネクションポイントは "マルチキャスティング" をサポートします。マルチキャスティングは、同じインターフェイスに接続された複数のシンクにブロードキャストする機能です。次の例では、1 つのコネクションポイントで各シンクに繰り返しアクセスすることで、マルチキャスティングを実現しています。

void CMyClass::CallSinkFunc()
{
    POSITION pos = m_xSampleConnPt.GetStartPosition();
    ISampleSink* pSampleSink;
    while( pos != NULL )
    {
        pSampleSink = (ISampleSink*)(m_xSampleConnPt.GetNextConnection(pos));
        if(pSampleSink != NULL)
            pSampleSink->SinkFunc();
    }
}

この例では、CConnectionPoint::GetConnections を呼び出して、コネクションポイント SampleConnPt での現在の接続を取得しています。その後、接続を繰り返し参照し、アクティブな接続ごとに ISampleSink::SinkFunc を呼び出します。

CConnectionPoint の使い方の詳細については、「コネクションポイント」を参照してください。