Kelas IDataObjectImpl

Kelas ini menyediakan metode untuk mendukung Transfer Data Seragam dan mengelola koneksi.

Penting

Kelas ini dan anggotanya tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime.

Sintaks

template<class T>
class IDataObjectImpl

Parameter

T
Kelas Anda, berasal dari IDataObjectImpl.

Anggota

Metode Publik

Nama	Deskripsi
IDataObjectImpl::D Advise	Membuat koneksi antara objek data dan sink saran. Ini memungkinkan sink saran untuk menerima pemberitahuan perubahan dalam objek.
IDataObjectImpl::D Unadvise	Mengakhiri koneksi yang sebelumnya dibuat melalui DAdvise.
IDataObjectImpl::EnumDAdvise	Membuat enumerator untuk melakukan iterasi melalui koneksi saran saat ini.
IDataObjectImpl::EnumFormatEtc	Membuat enumerator untuk melakukan iterasi melalui struktur yang FORMATETC didukung oleh objek data. Implementasi ATL mengembalikan E_NOTIMPL.
IDataObjectImpl::FireDataChange	Mengirim pemberitahuan perubahan kembali ke setiap sink saran.
IDataObjectImpl::GetCanonicalFormatEtc	Mengambil struktur yang setara FORMATETC secara logis dengan struktur yang lebih kompleks. Implementasi ATL mengembalikan E_NOTIMPL.
IDataObjectImpl::GetData	Mentransfer data dari objek data ke klien. Data dijelaskan dalam FORMATETC struktur dan ditransfer melalui STGMEDIUM struktur.
IDataObjectImpl::GetDataHere	Mirip GetDatadengan , kecuali klien harus mengalokasikan STGMEDIUM struktur. Implementasi ATL mengembalikan E_NOTIMPL.
IDataObjectImpl::QueryGetData	Menentukan apakah objek data mendukung struktur tertentu FORMATETC untuk mentransfer data. Implementasi ATL mengembalikan E_NOTIMPL.
IDataObjectImpl::SetData	Mentransfer data dari klien ke objek data. Implementasi ATL mengembalikan E_NOTIMPL.

Keterangan

Antarmuka IDataObject menyediakan metode untuk mendukung Transfer Data Seragam. IDataObject menggunakan struktur format standar FORMATETC dan STGMEDIUM untuk mengambil dan menyimpan data.

IDataObject juga mengelola koneksi untuk menyarankan sink untuk menangani pemberitahuan perubahan data. Agar klien menerima pemberitahuan perubahan data dari objek data, klien harus menerapkan antarmuka IAdviseSink pada objek yang disebut sink saran. Ketika klien kemudian memanggil IDataObject::DAdvise, koneksi dibuat antara objek data dan sink saran.

Kelas IDataObjectImpl menyediakan implementasi dan implementasi IDataObject IUnknown default dengan mengirim informasi ke perangkat cadangan dalam build debug.

Artikel Terkait Tutorial ATL, Membuat Proyek ATL

Hierarki Warisan

IDataObject

IDataObjectImpl

Persyaratan

Header: atlctl.h

IDataObjectImpl::D Advise

Membuat koneksi antara objek data dan sink saran.

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

Keterangan

Ini memungkinkan sink saran untuk menerima pemberitahuan perubahan dalam objek.

Untuk mengakhiri koneksi, panggil DUnadvise.

Lihat IDataObject::D Advise di Windows SDK.

IDataObjectImpl::D Unadvise

Mengakhiri koneksi yang sebelumnya dibuat melalui DAdvise.

HRESULT DUnadvise(DWORD dwConnection);

Keterangan

Lihat IDataObject::D Unadvise di Windows SDK.

IDataObjectImpl::EnumDAdvise

Membuat enumerator untuk melakukan iterasi melalui koneksi saran saat ini.

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

Keterangan

Lihat IDataObject::EnumDAdvise di Windows SDK.

IDataObjectImpl::EnumFormatEtc

Membuat enumerator untuk melakukan iterasi melalui struktur yang FORMATETC didukung oleh objek data.

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

Keterangan

Lihat IDataObject::EnumFormatEtc di Windows SDK.

Tampilkan Nilai

Mengembalikan E_NOTIMPL.

IDataObjectImpl::FireDataChange

Mengirim pemberitahuan perubahan kembali ke setiap sink saran yang saat ini sedang dikelola.

HRESULT FireDataChange();

Tampilkan Nilai

Nilai HRESULT standar.

IDataObjectImpl::GetCanonicalFormatEtc

Mengambil struktur yang setara FORMATETC secara logis dengan struktur yang lebih kompleks.

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

Tampilkan Nilai

Mengembalikan E_NOTIMPL.

Keterangan

Lihat IDataObject::GetCanonicalFormatEtc di Windows SDK.

IDataObjectImpl::GetData

Mentransfer data dari objek data ke klien.

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

Keterangan

Parameter pformatetcIn harus menentukan jenis media penyimpanan TYMED_MFPICT.

Lihat IDataObject::GetData di Windows SDK.

IDataObjectImpl::GetDataHere

Mirip GetDatadengan , kecuali klien harus mengalokasikan STGMEDIUM struktur.

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

Tampilkan Nilai

Mengembalikan E_NOTIMPL.

Keterangan

Lihat IDataObject::GetDataHere di Windows SDK.

IDataObjectImpl::QueryGetData

Menentukan apakah objek data mendukung struktur tertentu FORMATETC untuk mentransfer data.

HRESULT QueryGetData(FORMATETC* pformatetc);

Tampilkan Nilai

Mengembalikan E_NOTIMPL.

Keterangan

Lihat IDataObject::QueryGetData di Windows SDK.

IDataObjectImpl::SetData

Mentransfer data dari klien ke objek data.

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

Tampilkan Nilai

Mengembalikan E_NOTIMPL.

Keterangan

Lihat IDataObject::SetData di Windows SDK.

Lihat juga

Gambaran Umum Kelas