Struktur OBJECTDESCRIPTOR (oleidl.h)

Mewakili struktur data yang digunakan untuk format file CF_OBJECTDESRIPTOR dan CF_LINKSRCDESCRIPTOR. Format ini menyediakan informasi antarmuka pengguna selama operasi transfer data, misalnya, kotak dialog Tempel Spesial atau informasi umpan balik target selama operasi seret dan letakkan.

Sintaks

typedef struct tagOBJECTDESCRIPTOR {
  ULONG  cbSize;
  CLSID  clsid;
  DWORD  dwDrawAspect;
  SIZEL  sizel;
  POINTL pointl;
  DWORD  dwStatus;
  DWORD  dwFullUserTypeName;
  DWORD  dwSrcOfCopy;
} OBJECTDESCRIPTOR, *POBJECTDESCRIPTOR, *LPOBJECTDESCRIPTOR, LINKSRCDESCRIPTOR, *PLINKSRCDESCRIPTOR, *LPLINKSRCDESCRIPTOR;

Anggota

cbSize

Ukuran struktur, dalam byte.

clsid

CLSID objek sedang ditransfer. Clsid digunakan untuk mendapatkan ikon untuk opsi Tampilkan Sebagai Ikon dalam kotak dialog Tempel Spesial dan hanya berlaku jika format Sumber Sematkan atau Objek Tersemat ditawarkan. Jika tidak ada yang ditawarkan, nilai clsid harus CLSID_NULL. Clsid dapat diambil oleh sumber dengan memuat objek dan memanggil metode IOleObject::GetUserClassID . Perhatikan bahwa untuk objek tautan, nilai ini tidak sama dengan nilai yang dikembalikan oleh metode IPersist::GetClassID .

dwDrawAspect

Aspek tampilan objek. Biasanya, nilai ini DVASPECT_CONTENT atau DVASPECT_ICON. Jika aplikasi sumber tidak menggambar objek awalnya, bidang dwDrawAspect berisi nilai nol (yang tidak sama dengan DVASPECT_CONTENT). Untuk informasi selengkapnya, lihat DVASPECT.

sizel

Jangkauan sebenarnya dari objek (tanpa pemangkasan atau penskalaan) di unit HIMETRIC . Mengatur bidang ini bersifat opsional. Nilainya bisa (0,0) untuk aplikasi yang tidak menggambar objek yang sedang ditransfer. Bidang ini digunakan terutama oleh target operasi seret dan letakkan, sehingga dapat memberikan umpan balik yang sesuai kepada pengguna.

pointl

Offset dalam unit HIMETRIC dari sudut kiri atas objek tempat operasi seret dan letakkan dimulai. Bidang ini hanya bermakna untuk operasi transfer seret dan letakkan karena sesuai dengan titik di mana mouse diklik untuk memulai operasi seret dan letakkan. Nilainya adalah (0,0) untuk situasi transfer lainnya, seperti salinan clipboard dan tempel.

dwStatus

Salinan bendera status untuk objek. Bendera ini ditentukan oleh enumerasi OLEMISC . Jika objek yang disematkan sedang ditransfer, objek tersebut dikembalikan dengan memanggil metode IOleObject::GetMiscStatus .

dwFullUserTypeName

Offset untuk menemukan nama jenis pengguna lengkap dari objek yang sedang ditransfer. Ini menentukan offset, dalam byte, dari awal struktur data OBJECTDESCRIPTOR hingga string yang dihentikan null yang menentukan nama jenis pengguna lengkap objek yang ditransfer. Nilainya nol jika string tidak ada. String ini digunakan oleh tujuan transfer data untuk membuat label dalam kotak dialog Tempel Spesial . Aplikasi tujuan harus dapat menangani kasus ketika string ini dihilangkan.

dwSrcOfCopy

Offset, dalam byte, dari awal struktur data hingga string yang dihentikan null yang menentukan sumber transfer. Anggota dwSrcOfCopy biasanya diimplementasikan sebagai nama tampilan moniker sementara yang mengidentifikasi sumber data. Nilai untuk dwSrcOfCopy ditampilkan di baris Sumber dari kotak dialog Tempel Spesial . Nilai nol menunjukkan bahwa string tidak ada. Jika dwSrcOfCopy adalah nol, string "Sumber Tidak Diketahui" ditampilkan dalam kotak dialog Tempel Spesial .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	oleidl.h

Lihat juga

FORMATETC

IDataObject