Udostępnij przez

Klasa IDataObjectImpl

Ta klasa udostępnia metody obsługi ujednoliconego transferu danych i zarządzania połączeniami.

Ważne

Tej klasy i jej składowych nie można używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows.

Składnia

template<class T>
class IDataObjectImpl

Parametry

T
Klasa pochodząca z IDataObjectImplklasy .

Elementy członkowskie

Metody publiczne

Nazwa/nazwisko opis
IDataObjectImpl::D Advise Ustanawia połączenie między obiektem danych a ujściem doradcy. Dzięki temu ujście doradcy może otrzymywać powiadomienia o zmianach w obiekcie.
IDataObjectImpl::D Unadvise Przerywa połączenie wcześniej ustanowione za pośrednictwem polecenia DAdvise.
IDataObjectImpl::EnumDAdvise Tworzy moduł wyliczający do iterowania za pośrednictwem bieżących połączeń doradczych.
IDataObjectImpl::EnumFormatEtc Tworzy moduł wyliczający do iterowania po FORMATETC strukturach obsługiwanych przez obiekt danych. Implementacja ATL zwraca E_NOTIMPL.
IDataObjectImpl::FireDataChange Wysyła powiadomienie o zmianie z powrotem do każdego doradcy ujścia.
IDataObjectImpl::GetCanonicalFormatEtc Pobiera logicznie równoważną FORMATETC strukturę do tej, która jest bardziej złożona. Implementacja ATL zwraca E_NOTIMPL.
IDataObjectImpl::GetData Transferuje dane z obiektu danych do klienta. Dane są opisywane w FORMATETC strukturze i przesyłane za pomocą STGMEDIUM struktury.
IDataObjectImpl::GetDataHere Podobnie jak GetData, z wyjątkiem klienta musi przydzielić STGMEDIUM strukturę. Implementacja ATL zwraca E_NOTIMPL.
IDataObjectImpl::QueryGetData Określa, czy obiekt danych obsługuje określoną FORMATETC strukturę do przesyłania danych. Implementacja ATL zwraca E_NOTIMPL.
IDataObjectImpl::SetData Transferuje dane z klienta do obiektu danych. Implementacja ATL zwraca E_NOTIMPL.

Uwagi

Interfejs IDataObject udostępnia metody obsługi ujednoliconego transferu danych. IDataObject używa standardowych struktur formatowania FORMATETC i STGMEDIUM do pobierania i przechowywania danych.

IDataObject Zarządza również połączeniami, aby doradzać ujściom obsługę powiadomień o zmianie danych. Aby klient odbierał powiadomienia o zmianie danych z obiektu danych, klient musi zaimplementować interfejs IAdviseSink na obiekcie nazywanym ujściem doradcy. Gdy następnie klient wywołuje IDataObject::DAdvisemetodę , zostanie nawiązane połączenie między obiektem danych a ujściem doradcy.

Klasa IDataObjectImpl zapewnia domyślną implementację IDataObject i implementuje IUnknown , wysyłając informacje do urządzenia zrzutu w kompilacjach debugowania.

Powiązane artykuły ATL Tutorial, Creating an ATL Project (Samouczek dotyczący tworzenia projektu ATL)

Hierarchia dziedziczenia

IDataObject

IDataObjectImpl

Wymagania

Nagłówek: atlctl.h

IDataObjectImpl::D Advise

Ustanawia połączenie między obiektem danych a ujściem doradcy.

HRESULT DAdvise(
    FORMATETC* pformatetc,
    DWORD advf,
    IAdviseSink* pAdvSink,
    DWORD* pdwConnection);

Uwagi

Dzięki temu ujście doradcy może otrzymywać powiadomienia o zmianach w obiekcie.

Aby zakończyć połączenie, wywołaj metodę DUnadvise.

Zobacz IDataObject::D Advise w zestawie Windows SDK.

IDataObjectImpl::D Unadvise

Przerywa połączenie wcześniej ustanowione za pośrednictwem usługi DAdvise.

HRESULT DUnadvise(DWORD dwConnection);

Uwagi

Zobacz IDataObject::D Unadvise w zestawie Windows SDK.

IDataObjectImpl::EnumDAdvise

Tworzy moduł wyliczający do iterowania za pośrednictwem bieżących połączeń doradczych.

HRESULT DAdvise(
    FORMATETC* pformatetc,
    DWORD advf,
    IAdviseSink* pAdvSink,
    DWORD* pdwConnection);

Uwagi

Zobacz IDataObject::EnumDAdvise w zestawie Windows SDK.

IDataObjectImpl::EnumFormatEtc

Tworzy moduł wyliczający do iterowania po FORMATETC strukturach obsługiwanych przez obiekt danych.

HRESULT EnumFormatEtc(
    DWORD dwDirection,
    IEnumFORMATETC** ppenumFormatEtc);

Uwagi

Zobacz IDataObject::EnumFormatEtc w zestawie Windows SDK.

Wartość zwracana

Zwraca E_NOTIMPL.

IDataObjectImpl::FireDataChange

Wysyła powiadomienie o zmianie z powrotem do każdego doradcy, który jest obecnie zarządzany.

HRESULT FireDataChange();

Wartość zwracana

Standardowa wartość HRESULT.

IDataObjectImpl::GetCanonicalFormatEtc

Pobiera logicznie równoważną FORMATETC strukturę do tej, która jest bardziej złożona.

HRESULT GetCanonicalFormatEtc(FORMATETC* pformatetcIn, FORMATETC* pformatetcOut);

Wartość zwracana

Zwraca E_NOTIMPL.

Uwagi

Zobacz IDataObject::GetCanonicalFormatEtc w zestawie Windows SDK.

IDataObjectImpl::GetData

Transferuje dane z obiektu danych do klienta.

HRESULT GetData(
    FORMATETC* pformatetcIn,
    STGMEDIUM* pmedium);

Uwagi

Parametr pformatetcIn musi określać typ nośnika magazynu TYMED_MFPICT.

Zobacz IDataObject::GetData w zestawie Windows SDK.

IDataObjectImpl::GetDataHere

Podobnie jak GetData, z wyjątkiem klienta musi przydzielić STGMEDIUM strukturę.

HRESULT GetDataHere(
    FORMATETC* pformatetc,
    STGMEDIUM* pmedium);

Wartość zwracana

Zwraca E_NOTIMPL.

Uwagi

Zobacz IDataObject::GetDataHere w zestawie Windows SDK.

IDataObjectImpl::QueryGetData

Określa, czy obiekt danych obsługuje określoną FORMATETC strukturę do przesyłania danych.

HRESULT QueryGetData(FORMATETC* pformatetc);

Wartość zwracana

Zwraca E_NOTIMPL.

Uwagi

Zobacz IDataObject::QueryGetData w zestawie Windows SDK.

IDataObjectImpl::SetData

Transferuje dane z klienta do obiektu danych.

HRESULT SetData(
    FORMATETC* pformatetc,
    STGMEDIUM* pmedium,
    BOOL fRelease);

Wartość zwracana

Zwraca E_NOTIMPL.

Uwagi

Zobacz IDataObject::SetData w zestawie Windows SDK.

Zobacz też

Omówienie klasy

  • Last updated on