Struktur OLEUIPASTESPECIALA (oledlg.h)

Artikel
03/15/2023

Berisi informasi yang digunakan Pustaka Antarmuka Pengguna OLE untuk menginisialisasi kotak dialog Tempel Spesial , serta ruang bagi pustaka untuk mengembalikan informasi saat kotak dialog ditutup.

Sintaks

typedef struct tagOLEUIPASTESPECIALA {
  DWORD              cbStruct;
  DWORD              dwFlags;
  HWND               hWndOwner;
  LPCSTR             lpszCaption;
  LPFNOLEUIHOOK      lpfnHook;
  LPARAM             lCustData;
  HINSTANCE          hInstance;
  LPCSTR             lpszTemplate;
  HRSRC              hResource;
  LPDATAOBJECT       lpSrcDataObj;
  LPOLEUIPASTEENTRYA arrPasteEntries;
  int                cPasteEntries;
  UINT               *arrLinkTypes;
  int                cLinkTypes;
  UINT               cClsidExclude;
  LPCLSID            lpClsidExclude;
  int                nSelectedIndex;
  BOOL               fLink;
  HGLOBAL            hMetaPict;
  SIZEL              sizel;
} OLEUIPASTESPECIALA, *POLEUIPASTESPECIALA, *LPOLEUIPASTESPECIALA;

Anggota

cbStruct

Ukuran struktur, dalam byte. Anggota ini harus diisi pada input.

dwFlags

Pada input, dwFlags menentukan bendera inisialisasi dan pembuatan. Saat keluar, ini menentukan pilihan pengguna. Ini mungkin kombinasi dari bendera berikut.

Nilai	Makna
PSF_SHOWHELP	Kotak dialog akan menampilkan tombol Bantuan .
PSF_SELECTPASTE	Tombol radio Tempel akan dipilih pada startup kotak dialog. Ini adalah default, jika PSF_SELECTPASTE atau PSF_SELECTPASTELINK tidak ditentukan. Selain itu, ini menentukan status tombol pada penghentian dialog. Bendera IN/OUT.
PSF_SELECTPASTELINK	Tombol radio PasteLink akan dipilih pada startup kotak dialog. Selain itu, menentukan status tombol pada penghentian dialog. Bendera IN/OUT.
PSF_CHECKDISPLAYASICON	Apakah tombol radio Tampilkan Sebagai Ikon dicentang pada penghentian kotak dialog. Bendera OUT.
PSF_DISABLEDISPLAYASICON	Kotak centang Tampilkan Sebagai Ikon akan dinonaktifkan pada inisialisasi.
HIDECHANGEICON	Digunakan untuk menonaktifkan tombol ubah ikon dalam kotak dialog, yang tersedia untuk pengguna saat mereka menempelkan objek OLE secara default. Lihat STAYONCLIPBOARDCHANGE jika tidak.
STAYONCLIPBOARDCHANGE	Digunakan untuk memberi tahu kotak dialog untuk tetap aktif jika papan klip berubah saat kotak dialog aktif. Jika pengguna beralih ke aplikasi lain dan menyalin atau memotong sesuatu, kotak dialog akan, secara default, melakukan operasi pembatalan, yang akan menghapus kotak dialog karena opsi di tengah penyajian kepada pengguna tidak lagi diperbarui sehubungan dengan apa yang sebenarnya ada di clipboard.
NOREFRESHDATAOBJECT	Digunakan bersama dengan STAYONCLIPBOARDCHANGE (tidak melakukan apa pun sebaliknya). Jika papan klip berubah saat kotak dialog aktif dan STAYONCLIPBOARDCHANGE ditentukan, maka NOREFRESHDATAOBJECT menunjukkan bahwa kotak dialog TIDAK boleh menyegarkan konten kotak dialog untuk mencerminkan konten baru clipboard. Ini berguna jika aplikasi menggunakan kotak dialog paste-special pada IDataObject selain yang ada di clipboard, misalnya, sebagai bagian dari operasi seret dan letakkan klik kanan.

hWndOwner

Jendela yang memiliki kotak dialog. Anggota ini tidak boleh NULL.

lpszCaption

Penunjuk ke string yang akan digunakan sebagai judul kotak dialog. Jika NULL, maka pustaka menggunakan Tempel Spesial.

lpfnHook

Arahkan ke fungsi hook yang memproses pesan yang ditujukan untuk kotak dialog. Fungsi hook harus mengembalikan nol untuk meneruskan pesan bahwa tidak diproses kembali ke prosedur kotak dialog di pustaka. Fungsi hook harus mengembalikan nilai bukan nol untuk mencegah prosedur kotak dialog pustaka memproses pesan yang telah diproses.

lCustData

Data yang ditentukan aplikasi yang diteruskan pustaka ke fungsi hook yang ditujukkan oleh anggota lpfnHook . Pustaka meneruskan penunjuk ke struktur OLEUIPASTESPECIAL dalam parameter lParam dari pesan WM_INITDIALOG; pointer ini dapat digunakan untuk mengambil anggota lCustData .

hInstance

Instans yang berisi templat kotak dialog yang ditentukan oleh anggota lpTemplateName .

lpszTemplate

Penunjuk ke string yang dihentikan null yang menentukan nama file sumber daya untuk templat kotak dialog yang akan diganti untuk templat kotak dialog Tempel Khusus pustaka.

hResource

Handel templat yang dikustomisasi.

lpSrcDataObj

Arahkan ke antarmuka IDataObject objek data yang akan ditempelkan (dari clipboard). Anggota ini diisi pada input. Jika lpSrcDataObj adalah NULL ketika OleUIPasteSpecial dipanggil, maka OleUIPasteSpecial akan mencoba mengambil pointer ke IDataObject dari clipboard. Jika OleUIPasteSpecial berhasil, pemanggil bertanggung jawab untuk membebaskan IDataObject yang dikembalikan di lpSrcDataObj.

arrPasteEntries

Array OLEUIPASTEENTRY yang menentukan format yang dapat diterima. Anggota ini diisi pada input.

cPasteEntries

Jumlah entri array OLEUIPASTEENTRY . Anggota ini diisi pada input.

arrLinkTypes

Daftar jenis tautan yang dapat diterima. Jenis tautan disebut menggunakan OLEUIPASTEFLAG di arrPasteEntries. Anggota ini diisi pada input.

cLinkTypes

Jumlah jenis tautan. Anggota ini diisi pada input.

cClsidExclude

Jumlah CLSID dalam lpClsidExclude. Anggota ini diisi pada input.

lpClsidExclude

Penunjuk ke array CLSID untuk dikecualikan dari daftar objek server yang tersedia untuk operasi Tempel. Perhatikan bahwa ini tidak memengaruhi Tempel Tautan. Aplikasi dapat mencegah penyematan ke dalam dirinya sendiri dengan mencantumkan CLSID sendiri dalam daftar ini. Bidang ini diisi pada input.

nSelectedIndex

Indeks arrPasteEntries yang dipilih pengguna. Anggota ini diisi pada output.

fLink

Apakah Tempel atau Tempel Tautan dipilih oleh pengguna. Anggota ini diisi pada output.

hMetaPict

Tangani ke Metafile yang berisi ikon dan judul ikon yang dipilih oleh pengguna. Anggota ini diisi pada output.

sizel

Ukuran objek seperti yang ditampilkan di sumbernya, jika aspek tampilan yang dipilih oleh pengguna cocok dengan aspek yang ditampilkan di sumber. Jika pengguna memilih aspek yang berbeda, maka sizel.cx dan sizel.cy keduanya diatur ke nol. Ukuran objek seperti yang ditampilkan di sumber diambil dari ObjectDescriptor jika fLinkFALSE dan dari LinkSrcDescriptor jika fLinkTRUE. Anggota ini diisi pada output.

Keterangan

Catatan

Header oledlg.h mendefinisikan OLEUIPASTESPECIAL sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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

OLEUIPASTEENTRY

OLEUIPASTEFLAG

OleUIPasteSpecial

Bagikan melalui