Antarmuka IDataObject (objidl.h)

Mengaktifkan transfer data dan pemberitahuan perubahan data. Metode transfer data menentukan format data yang ditransfer bersama dengan media tempat data akan ditransfer. Secara opsional, data dapat dirender untuk perangkat target tertentu. Selain metode untuk mengambil dan menyimpan data, antarmuka IDataObject menentukan metode untuk menghitung format yang tersedia dan mengelola koneksi ke sink penasihat untuk menangani pemberitahuan perubahan.

Istilah objek data digunakan untuk berarti objek apa pun yang mendukung implementasi antarmuka IDataObject . Implementasi bervariasi, tergantung pada apa yang harus dilakukan objek data; dalam beberapa objek data, implementasi metode tertentu yang tidak didukung oleh objek hanya bisa menjadi pengembalian E_NOTIMPL. Misalnya, beberapa objek data tidak mengizinkan penelepon untuk mengirimi mereka data. Objek data lain tidak mendukung koneksi penasihat dan mengubah pemberitahuan. Namun, untuk objek data yang mendukung pemberitahuan perubahan, OLE menyediakan objek yang disebut pemegang saran data. Penunjuk antarmuka ke pemegang ini tersedia melalui panggilan ke fungsi pembantu CreateDataAdviseHolder. Objek data dapat memiliki beberapa koneksi, masing-masing dengan sekumpulan atributnya sendiri. Pemegang saran data OLE menyederhanakan tugas mengelola koneksi ini dan mengirim pemberitahuan yang sesuai.

Warisan

Antarmuka IDataObject mewarisi dari antarmuka IUnknown . IDataObject juga memiliki jenis anggota ini:

Metode

Antarmuka IDataObject memiliki metode ini.

IDataObject::D Advise Dipanggil oleh objek yang mendukung sink saran untuk membuat koneksi antara objek data dan sink saran. Ini memungkinkan sink saran untuk diberi tahu tentang perubahan dalam data objek.
IDataObject::D Unadvise Menghancurkan koneksi pemberitahuan yang telah disiapkan sebelumnya.
IDataObject::EnumdAdvise Membuat objek yang dapat digunakan untuk menghitung koneksi penasihat saat ini.
IDataObject::EnumFormatEtc Membuat objek untuk menghitung format yang didukung oleh objek data.
IDataObject::GetCanonicalFormatEtc Menyediakan struktur FORMATETC yang berpotensi berbeda tetapi setara secara logis. Anda menggunakan metode ini untuk menentukan apakah dua struktur FORMATETC yang berbeda akan mengembalikan data yang sama, menghapus kebutuhan akan penyajian duplikat.
IDataObject::GetData Dipanggil oleh konsumen data untuk mendapatkan data dari objek data sumber.
IDataObject::GetDataHere Dipanggil oleh konsumen data untuk mendapatkan data dari objek data sumber. Metode ini berbeda dari metode GetData karena pemanggil harus mengalokasikan dan membebaskan media penyimpanan yang ditentukan.
IDataObject::QueryGetData Menentukan apakah objek data mampu merender data seperti yang ditentukan. Objek yang mencoba operasi tempel atau jatuhkan dapat memanggil metode ini sebelum memanggil IDataObject::GetData untuk mendapatkan indikasi apakah operasi mungkin berhasil.
IDataObject::SetData Dipanggil oleh objek yang berisi sumber data untuk mentransfer data ke objek yang mengimplementasikan metode ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	objidl.h