Struktur OLEUIPASTEENTRYA (oledlg.h)

Artikel
03/15/2023

Array entri yang akan ditentukan dalam struktur OLEUIPASTESPECIAL untuk kotak dialog Tempel Spesial . Setiap entri menyertakan struktur FORMATETC yang menentukan format yang dapat diterima, string yang mewakili format dalam kotak daftar kotak dialog, string untuk menyesuaikan teks hasil kotak dialog, dan sekumpulan bendera dari enumerasi OLEUIPASTEFLAG . Bendera menunjukkan apakah entri valid hanya untuk menempelkan, hanya menautkan atau menempelkan dan menautkan. Jika entri valid untuk penautan, bendera menunjukkan jenis tautan mana yang dapat diterima oleh OR yang menyatukan nilai OLEUIPASTE_LINKTYPEn yang sesuai.

Sintaks

typedef struct tagOLEUIPASTEENTRYA {
  FORMATETC fmtetc;
  LPCSTR    lpstrFormatName;
  LPCSTR    lpstrResultText;
  DWORD     dwFlags;
  DWORD     dwScratchSpace;
} OLEUIPASTEENTRYA, *POLEUIPASTEENTRYA, *LPOLEUIPASTEENTRYA;

Anggota

fmtetc

Format yang dapat diterima. Kotak dialog Tempel Spesial mencentang apakah format ini ditawarkan oleh objek pada clipboard dan jika demikian, menawarkannya untuk dipilih kepada pengguna.

lpstrFormatName

Penunjuk ke string yang mewakili format kepada pengguna. Setiap %s dalam string ini digantikan oleh FullUserTypeName objek pada clipboard dan string yang dihasilkan ditempatkan dalam kotak daftar kotak dialog. Hanya satu %s yang diperbolehkan. Kehadiran atau tidak adanya %s menentukan apakah teks hasil adalah untuk menunjukkan bahwa data sedang ditempelkan atau bahwa objek yang dapat diaktifkan oleh aplikasi sedang ditempelkan. Jika %s ada, teks yang dihasilkan mengatakan bahwa objek sedang ditempelkan. Jika tidak, dikatakan bahwa data sedang ditempelkan.

lpstrResultText

Penunjuk ke string yang digunakan untuk mengkustomisasi teks yang dihasilkan dari kotak dialog saat pengguna memilih format yang terkait dengan entri ini. Setiap %s dalam string ini digantikan oleh nama aplikasi atau FullUserTypeName objek pada clipboard. Hanya satu %s yang diperbolehkan.

dwFlags

Nilai dari enumerasi OLEUIPASTEFLAG .

dwScratchSpace

Ruang coretan tersedia untuk rutinitas yang mengulang IEnumFORMATETC untuk menandai apakah format PasteEntry tersedia. Bidang ini dapat dibiarkan tidak diinisialisasi.

Keterangan

Catatan

Header oledlg.h mendefinisikan OLEUIPASTEENTRY sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

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

Lihat juga

OLEUIPASTEFLAG

OLEUIPASTESPECIAL

OleUIPasteSpecial

Bagikan melalui