Bagikan melalui

Struktur FORMATETC

  • Artikel

Struktur FORMATETC adalah format clipboard umum, ditingkatkan untuk mencakup perangkat target, aspek atau tampilan data, dan media penyimpanan. Pihak yang menggunakan data, seperti aplikasi wadah OLE, meneruskan struktur FORMATETC sebagai argumen dalam panggilan ke IDataObject untuk menunjukkan jenis data yang diinginkan dari sumber data, seperti objek dokumen majemuk. Sumber menggunakan struktur FORMATETC untuk menjelaskan format apa yang dapat disediakannya.

FORMATETC dapat menjelaskan hampir semua data, termasuk objek lain seperti moniker. Kontainer dapat meminta salah satu objek yang disematkan untuk mencantumkan format datanya dengan memanggil IDataObject::EnumFormatEtc, yang mengembalikan objek enumerator yang mengimplementasikan antarmuka IEnumFORMATETC. Alih-alih menjawab hanya bahwa ia memiliki "teks dan bitmap," objek dapat memberikan deskripsi terperinci tentang data, termasuk perangkat (biasanya layar atau printer) yang dirender, aspek yang akan disajikan kepada pengguna (konten lengkap, gambar mini, ikon, atau diformat untuk pencetakan), dan media penyimpanan yang berisi data (memori global, file disk, objek penyimpanan, atau aliran). Kemampuan untuk menggambarkan data secara ringkas ini, seiring waktu, akan menghasilkan output printer dan layar berkualitas lebih tinggi serta efisiensi lebih besar dalam penelusuran data, di mana pratinjau jauh lebih cepat untuk diambil dan ditampilkan daripada penyajian yang sepenuhnya terperinci.

Tabel berikut ini mencantumkan field dari struktur data FORMATETC dan informasi yang dijelaskan oleh field tersebut.

Ladang Menetapkan
cfFormat
 Format di mana data akan dirender, yang dapat berupa format clipboard standar, format kepemilikan, atau format OLE. Untuk informasi selengkapnya tentang format OLE, lihat Dokumen Gabungan.
ptd
 Struktur DVTARGETDEVICE, yang berisi informasi yang memadai tentang perangkat target Windows, seperti layar atau printer, sehingga pegangan ke konteks perangkat tersebut (hDC) dapat dibuat menggunakan fungsi CreateDC.
dwAspect
 Aspek atau tampilan data yang akan dirender; dapat berupa konten lengkap, sketsa gambar mini, ikon, atau diformat untuk pencetakan.
lindex
 Bagian dari aspek yang menarik; untuk saat ini, nilainya harus -1, menunjukkan bahwa seluruh tampilan menarik.
dipasangi
 Media penyimpanan data, yang dapat berupa memori global, file disk, atau instans salah satu antarmuka penyimpanan terstruktur COM.

Format Data dan Transfer Media