Struktur FORMATETC (objidl.h)

Artikel
08/25/2023

Mewakili format clipboard umum. Ini ditingkatkan untuk mencakup perangkat target, aspek atau tampilan data, dan indikator media penyimpanan. Di mana seseorang mungkin mengharapkan untuk menemukan format clipboard, OLE menggunakan struktur data FORMATETC sebagai gantinya. Struktur ini digunakan sebagai parameter dalam fungsi dan metode OLE yang memerlukan informasi format data.

Sintaks

typedef struct tagFORMATETC {
  CLIPFORMAT     cfFormat;
  DVTARGETDEVICE *ptd;
  DWORD          dwAspect;
  LONG           lindex;
  DWORD          tymed;
} FORMATETC, *LPFORMATETC;

Anggota

cfFormat

Format clipboard yang menarik. Ada tiga jenis format yang dikenali oleh OLE:

Format pertukaran standar, seperti CF_TEXT.
Format aplikasi privat hanya dipahami oleh aplikasi yang menawarkan format , atau oleh aplikasi lain yang menawarkan fitur serupa.
Format OLE, yang digunakan untuk membuat objek yang ditautkan atau disematkan.

ptd

Penunjuk ke struktur DVTARGETDEVICE yang berisi informasi tentang perangkat target tempat data sedang disusun. Nilai NULL digunakan setiap kali format data yang ditentukan tidak bergantung pada perangkat target atau ketika pemanggil tidak peduli perangkat apa yang digunakan. Dalam kasus terakhir, jika data memerlukan perangkat target, objek harus memilih perangkat default yang sesuai (seringkali tampilan untuk komponen visual). Data yang diperoleh dari objek dengan perangkat target NULL , seperti sebagian besar metafiles, tidak bergantung pada perangkat target. Data yang dihasilkan biasanya sama seperti jika pengguna memilih perintah Simpan Sebagai dari menu File dan memilih format pertukaran.

dwAspect

Menunjukkan berapa banyak detail yang harus dimuat dalam penyajian. Parameter ini harus menjadi salah satu nilai enumerasi DVASPECT . Format clipboard tunggal dapat mendukung beberapa aspek atau tampilan objek. Sebagian besar metode transfer dan penembolokan data dan presentasi meneruskan informasi aspek. Misalnya, penelepon mungkin meminta gambar ikon objek, menggunakan format clipboard metafile untuk mengambilnya. Perhatikan bahwa hanya satu nilai DVASPECT yang dapat digunakan dalam dwAspect. Artinya, dwAspect tidak dapat menjadi hasil dari operasi Boolean OR pada beberapa nilai DVASPECT .

lindex

Bagian dari aspek ketika data harus dibagi di seluruh batas halaman. Nilai yang paling umum adalah -1, yang mengidentifikasi semua data. Untuk aspek DVASPECT_THUMBNAIL dan DVASPECT_ICON, lindex diabaikan.

tymed

Salah satu konstanta enumerasi TYMED yang menunjukkan jenis media penyimpanan yang digunakan untuk mentransfer data objek. Data dapat ditransfer menggunakan media apa pun yang masuk akal untuk objek. Misalnya, data dapat diteruskan menggunakan memori global, file disk, atau objek penyimpanan terstruktur. Untuk informasi selengkapnya, lihat enumerasi TYMED .

Keterangan

Struktur FORMATETC digunakan oleh metode dalam antarmuka transfer data dan presentasi sebagai parameter yang menentukan data yang sedang ditransfer. Misalnya, metode IDataObject::GetData menggunakan struktur FORMATETC untuk menunjukkan dengan tepat jenis data apa yang diminta pemanggil.

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]
Header	objidl.h