Fungsi OleUIPasteSpecialA (oledlg.h)

Artikel
03/01/2024

Memanggil kotak dialog Tempel Spesial standar, memungkinkan pengguna memilih format objek clipboard untuk ditempel atau ditautkan tempel.

Sintaks

UINT OleUIPasteSpecialA(
  [in] LPOLEUIPASTESPECIALA unnamedParam1
);

Parameter

[in] unnamedParam1

Penunjuk ke struktur OLEUIPASTESPECIAL .

Nilai kembali

Definisi Keberhasilan/Kesalahan Standar

Menampilkan kode	Deskripsi
OLEUI_FALSE	Kegagalan tidak diketahui (tidak digunakan).
OLEUI_OK	Pengguna menekan tombol OK.
OLEUI_SUCCESS	Tidak ada kesalahan, sama seperti OLEUI_OK.
OLEUI_CANCEL	Pengguna menekan tombol Batalkan.

Kesalahan Validasi Bidang Standar

Menampilkan kode	Deskripsi
OLEUI_ERR_STANDARDMIN	Kesalahan umum untuk semua kotak dialog terletak di rentang OLEUI_ERR_STANDARDMIN untuk OLEUI_ERR_STANDARDMAX. Nilai ini memungkinkan aplikasi untuk menguji pesan standar untuk menampilkan pesan kesalahan kepada pengguna.
OLEUI_ERR_STRUCTURENULL	Penunjuk ke struktur OLEUIXXX yang diteruskan ke fungsi adalah NULL.
OLEUI_ERR_STRUCTUREINVALID	Izin untuk akses baca atau tulis ke struktur OLEUIXXX tidak cukup.
OLEUI_ERR_CBSTRUCTINCORRECT	Nilai cbstruct salah.
OLEUI_ERR_HWNDOWNERINVALID	Nilai hWndOwner tidak valid.
OLEUI_ERR_LPSZCAPTIONINVALID	Nilai lpszCaption tidak valid.
OLEUI_ERR_LPFNHOOKINVALID	Nilai lpfnHook tidak valid.
OLEUI_ERR_HINSTANCEINVALID	Nilai hInstance tidak valid.
OLEUI_ERR_LPSZTEMPLATEINVALID	Nilai lpszTemplate tidak valid.
OLEUI_ERR_HRESOURCEINVALID	Nilai hResource tidak valid.

Kesalahan Inisialisasi

Menampilkan kode	Deskripsi
OLEUI_ERR_FINDTEMPLATEFAILURE	Tidak dapat menemukan templat kotak dialog.
OLEUI_ERR_LOADTEMPLATEFAILURE	Tidak dapat memuat templat kotak dialog.
OLEUI_ERR_DIALOGFAILURE	Inisialisasi kotak dialog gagal.
OLEUI_ERR_LOCALMEMALLOC	Panggilan ke LocalAlloc atau alokator IMalloc standar gagal.
OLEUI_ERR_GLOBALMEMALLOC	Panggilan ke GlobalAlloc atau alokator IMalloc standar gagal.
OLEUI_ERR_LOADSTRING	Tidak dapat memanggil LoadString untuk mendapatkan sumber daya yang dilokalkan dari pustaka.
OLEUI_ERR_OLEMEMALLOC	Panggilan ke alokator IMalloc standar gagal.

Kesalahan Spesifik Fungsi

Menampilkan kode	Deskripsi
OLEUI_ERR_STANDARDMAX	Kesalahan umum untuk semua kotak dialog terletak di rentang OLEUI_ERR_STANDARDMIN untuk OLEUI_ERR_STANDARDMAX. Nilai ini memungkinkan aplikasi untuk menguji pesan standar untuk menampilkan pesan kesalahan kepada pengguna.
OLEUI_IOERR_SRCDATAOBJECTINVALID	Anggota lpSrcDataObjectdari OLEUIPASTESPECIAL tidak valid.
OLEUI_IOERR_ARRPASTEENTRIESINVALID	Anggota arrPasteEntries dari OLEUIPASTESPECIAL tidak valid.
OLEUI_IOERR_ARRLINKTYPESINVALID	Anggota arrLinkTypesdari OLEUIPASTESPECIAL tidak valid.
OLEUI_PSERR_CLIPBOARDCHANGED	Isi papan klip berubah saat kotak dialog ditampilkan.
OLEUI_PSERR_GETCLIPBOAARDFAILED	Anggota lpSrcDataObj salah.

Keterangan

Desain kotak dialog Tempel Spesial mengasumsikan bahwa jika Anda bersedia mengizinkan pengguna untuk menautkan ke objek, Anda juga bersedia mengizinkan pengguna untuk menyematkan objek tersebut. Untuk alasan ini, jika salah satu bendera OLEUIPASTE_LINKTYPE yang terkait dengan enumerasi OLEUIPASTEFLAG diatur, maka bendera OLEUIPASTE_PASTE juga harus diatur agar format data muncul dalam kotak dialog Tempel Khusus .

Teks yang ditampilkan di bidang Sumber dari kotak dialog Tempel Spesial standar, yang diimplementasikan dalam Oledlg32.dll, adalah string null-terminated yang offset-nya dalam byte ditentukan dalam anggota dwSrcofCopy dari struktur OBJECTDESCRIPTOR untuk objek yang akan ditempelkan. Jika struktur OBJECTDESCRIPTOR tidak tersedia untuk objek ini, kotak dialog menampilkan teks apa pun yang mungkin terkait dengan CF_LINKSOURCEDESCRIPTOR. Jika tidak ada struktur yang tersedia, kotak dialog mencari CF_FILENAME. Jika CF_FILENAME tidak ditemukan, kotak dialog menampilkan string "Sumber Tidak Diketahui".

Untuk membebaskan HMETAFILEPICT yang dikembalikan dari kotak dialog Sisipkan Objek atau Tempel Spesial , hapus metafile terlampir pada gagang, sebagai berikut.

 
void FreeHmetafilepict(HMETAFILEPICT hmfp) 
{ 
    if (hmfp != NULL) 
        { 
        LPMETAFILEPICT pmfp = GlobalLock(hmfp); 
 
        DeleteMetaFile(pmfp-&gt;hMF); 
        GlobalUnlock(hmfp); 
        GlobalFree(hmfp); 
        } 
    else
        {
        // Handle null pointers here.
        exit(0);
        }
}  // FreeHmetafilepict

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]
Target Platform	Windows
Header	oledlg.h
Pustaka	OleDlg.lib
DLL	OleDlg.dll

Lihat juga

OLEUIPASTEFLAG

Bagikan melalui