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 IObjectWithSiteImpl
klasy .
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 SetSite
element , 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.