Udostępnij za pośrednictwem


Klasa IObjectWithSiteImpl

Ta klasa udostępnia metody umożliwiające obiektowi komunikowanie się z jego lokacją.

Składnia

template <class T>
    class ATL_NO_VTABLE IObjectWithSiteImpl :
    public IObjectWithSite

Parametry

T
Klasa pochodząca z IObjectWithSiteImplklasy .

Elementy członkowskie

Metody publiczne

Nazwa/nazwisko opis
IObjectWithSiteImpl::GetSite Wysyła zapytanie do witryny dla wskaźnika interfejsu.
IObjectWithSiteImpl::SetChildSite Udostępnia obiekt wskaźnikowi lokacji IUnknown .
IObjectWithSiteImpl::SetSite Udostępnia obiekt wskaźnikowi lokacji IUnknown .

Publiczne elementy członkowskie danych

Nazwa/nazwisko opis
IObjectWithSiteImpl::m_spUnkSite Zarządza wskaźnikiem lokacji IUnknown .

Uwagi

Interfejs IObjectWithSite umożliwia obiektowi komunikowanie się z jego lokacją. Klasa IObjectWithSiteImpl zapewnia domyślną implementację tego interfejsu i implementuje IUnknown przez wysyłanie informacji do urządzenia zrzutu w kompilacjach debugowania.

IObjectWithSiteImpl określa dwie metody. Klient najpierw wywołuje SetSiteelement , przekazując wskaźnik lokacji IUnknown . Ten wskaźnik jest przechowywany w obiekcie i można go później pobrać za pomocą wywołania metody GetSite.

Zazwyczaj klasę należy utworzyć podczas IObjectWithSiteImpl tworzenia obiektu, który nie jest kontrolką. W przypadku kontrolek należy utworzyć klasę z interfejsu IOleObjectImpl, który udostępnia również wskaźnik lokacji. Nie należy wyprowadzać klasy zarówno z klasy , jak IObjectWithSiteImpl i IOleObjectImpl.

Hierarchia dziedziczenia

IObjectWithSite

IObjectWithSiteImpl

Wymagania

Nagłówek: atlcom.h

IObjectWithSiteImpl::GetSite

Wysyła zapytanie do witryny wskaźnika do interfejsu zidentyfikowanego przez riid.

STDMETHOD(GetSite)(
    REFIID riid,
    void** ppvSite);

Uwagi

Jeśli lokacja obsługuje ten interfejs, wskaźnik jest zwracany za pośrednictwem metody ppvSite. ppvSite W przeciwnym razie ustawiono wartość NULL.

Zobacz IObjectWithSite::GetSite w zestawie Windows SDK.

IObjectWithSiteImpl::m_spUnkSite

Zarządza wskaźnikiem lokacji IUnknown .

CComPtr<IUnknown> m_spUnkSite;

Uwagi

m_spUnkSite początkowo otrzymuje ten wskaźnik za pośrednictwem wywołania polecenia SetSite.

IObjectWithSiteImpl::SetChildSite

Udostępnia obiekt wskaźnikowi lokacji IUnknown .

HRESULT SetChildSite(IUnknown* pUnkSite);

Parametry

PUnkSite
[in] Wskaźnik do IUnknown wskaźnika interfejsu lokacji zarządzającej tym obiektem. Jeśli wartość NULL, obiekt powinien wywołać dowolną IUnknown::Release istniejącą lokację, w której obiekt nie wie już jego lokacji.

Wartość zwracana

Zwraca S_OK.

IObjectWithSiteImpl::SetSite

Udostępnia obiekt wskaźnikowi lokacji IUnknown .

STDMETHOD(SetSite)(IUnknown* pUnkSite);

Uwagi

Zobacz IObjectWithSite::SetSite w zestawie Windows SDK.

Zobacz też

Omówienie klasy