Classe di CConnectionPoint

Articolo
03/05/2013

Definisce un tipo speciale di interfaccia utilizzata per comunicare con altri oggetti OLE, denominato "un punto di connessione."

class CConnectionPoint : public CCmdTarget

Membri

Costruttori pubblici

Nome	Descrizione
CConnectionPoint::CConnectionPoint	Costruisce un oggetto CConnectionPoint.

Metodi pubblici

Nome	Descrizione
CConnectionPoint::GetConnections	Recupera tutti i punti di connessione in una mappa delle connessioni.
CConnectionPoint::GetContainer	Recupera il contenitore controllo proprietario della mappa delle connessioni.
CConnectionPoint::GetIID	Recupera l'id di interfaccia di un punto di connessione.
CConnectionPoint::GetMaxConnections	Recupera il numero massimo di punti di connessione supportato da un controllo.
CConnectionPoint::GetNextConnection	Recupera un puntatore all'elemento di collegamento a pos.
CConnectionPoint::GetStartPosition	Inizia un'iterazione di mapping restituendo un valore di percorso che può essere passato a una chiamata GetNextConnection.
CConnectionPoint::OnAdvise	Chiamato dal framework quando si definiscono o interrompendo le connessioni.
CConnectionPoint::QuerySinkInterface	Recupera un puntatore a un'interfaccia richiesta del sink.

Note

A differenza delle normali interfacce OLE, utilizzate per implementare ed esporre la funzionalità di un controllo OLE, a un punto di connessione un'interfaccia in uscita che può iniziare azioni su altri oggetti, ad esempio gli eventi di consentono e notifiche di modifica.

Una connessione è costituita da due parti: l'oggetto che chiama l'interfaccia, definita "l'origine," e l'oggetto che implementa l'interfaccia, denominato "sink." Esponendo un punto di connessione, un database di origine consente ai sink stabilire connessioni se stesso.Tramite il meccanismo dei punti di connessione, un oggetto di origine ottiene un puntatore all'implementazione del sink di un set di funzioni membro.Ad esempio, per generare un evento implementato dal sink, l'origine può chiamare il metodo appropriato dell'implementazione del sink.

Per impostazione predefinita, COleControlnella classe derivata implementa due punti di connessione: uno per gli eventi e uno per le notifiche di modifica della proprietà.Queste connessioni vengono utilizzate, rispettivamente, che consentono di eventi e per la comunicazione del sink, ad esempio il contenitore del controllo) quando un valore di proprietà è stato modificato.Il supporto inoltre disponibile per i controlli OLE implementare i punti di connessione aggiuntivi.Per ogni punto di connessione aggiuntivo implementato nella classe del controllo, è necessario dichiarare "una parte della connessione" che implementa il punto di connessione.Se si implementa uno o più punti di connessione, è necessario dichiarare una singola "mappa delle connessioni" nella classe del controllo.

L'esempio seguente illustra una mappa di connessioni semplice e un punto di connessione per il controllo OLE Sample, consistenti di due frammenti di codice: la prima parte dichiara la mappa delle connessioni e il punto; il secondo implementa questi mapping e scegliere.Il primo frammento viene inserito nella dichiarazione della classe del controllo, sotto la sezione protected :

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

 DECLARE_CONNECTION_MAP()

Le macro END_CONNECTION_PART e BEGIN_CONNECTION_PART creando una classe incorporata, XSampleConnPt (derivata da CConnectionPoint) che implementa questo punto di connessione specifica.Se si desidera eseguire l'override delle funzioni membro CConnectionPoint, o aggiungere le funzioni membro personalizzati, dichiarile tra queste due macro.Ad esempio, la macro CONNECTION_IID esegue l'override della funzione membro CConnectionPoint::GetIID quando inserito tra queste due macro.

Il secondo frammento di codice viene inserito nel file di implementazione (.CPP) della classe del controllo.Questo codice implementa la mappa delle connessioni, inclusi il punto di connessione aggiuntivo, SampleConnPt:

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

Una volta che questi frammenti di codice sono stati inseriti, il controllo OLE di esempio espone un punto di connessione per l'interfaccia ISampleSink.

In genere, i punti di connessione supportano il "multicasting", che è la possibilità di carattere per comunicare ai sink più connesso alla stessa interfaccia.Nel frammento di codice che illustra come eseguire il multicasting scorrendo ogni sink su un punto di connessione:

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

L'esempio recupera l'impostazione corrente delle connessioni sul punto di connessione SampleConnPt con una chiamata a CConnectionPoint::GetConnections.Si scorre le connessioni e chiama ISampleSink::SinkFunc su ogni connessione attiva.

Per ulteriori informazioni su l CConnectionPoint, vedere l'articolo Punti di connessione.