Fungsi OleUIInsertObjectA (oledlg.h)

Artikel
03/01/2024

Memanggil kotak dialog Sisipkan Objek standar, yang memungkinkan pengguna untuk memilih sumber objek dan nama kelas, serta opsi untuk menampilkan objek itu sendiri atau sebagai ikon.

Sintaks

UINT OleUIInsertObjectA(
  [in] LPOLEUIINSERTOBJECTA unnamedParam1
);

Parameter

[in] unnamedParam1

Arahkan ke struktur OLEUIINSERTOBJECT masuk untuk kotak dialog ini.

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 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_LPSZFILEINVALID	Nilai lpszFile tidak valid atau pengguna memiliki izin akses tulis yang tidak memadai. Anggota lpszFile ini menunjuk ke nama file yang ditautkan ke atau disisipkan.
OLEUI_IOERR_PPVOBJINVALID	Nilai ppvOjb tidak valid. Anggota ini menunjuk ke lokasi tempat penunjuk untuk objek dikembalikan.
OLEUI_IOERR_LPIOLECLIENTSITEINVALID	Nilai lpIOleClientSite tidak valid. Anggota ini menunjuk ke situs klien untuk objek tersebut.
OLEUI_IOERR_LPISTORAGEINVALID	Nilai lpIStorage tidak valid. Anggota ini menunjuk ke penyimpanan yang akan digunakan untuk objek .
OLEUI_IOERR_SCODEHASERROR	Anggota scdari lpIO memiliki informasi kesalahan tambahan.
OLEUI_IOERR_LPCLSIDEXCLUDEINVALID	Nilai lpClsidExclude tidak valid. Anggota ini berisi daftar CLSID yang akan dikecualikan.
OLEUI_IOERR_CCHFILEINVALID	Nilai cchFile atau lpszFile tidak valid. Anggota cchFile menentukan ukuran buffer lpszFile . Anggota lpszFile menunjuk ke nama file yang ditautkan ke atau disisipkan.

Keterangan

OleUIInsertObject memungkinkan pengguna untuk memilih jenis objek yang akan disisipkan dari kotak daftar yang berisi aplikasi objek yang terdaftar di sistem pengguna. Untuk mengisi kotak daftar tersebut, OleUIInsertObject melintasi registri, menambahkan setiap server objek yang ditemukan yang memenuhi kriteria berikut:

Entri registri tidak menyertakan kunci NotInsertable.
Entri registri menyertakan OLE 1.0 style Protocol\\StdFileEditing\\Server key.
Entri registri menyertakan kunci yang dapat disisipkan.
CLSID objek tidak disertakan dalam daftar objek yang akan dikecualikan (anggota lpClsidExcludedari OLEUIINSERTOBJECT).

Secara default, OleUIInsertObject tidak memvalidasi server objek, namun, jika bendera IOF_VERIFYSERVEREXIST disertakan dalam anggota dwFlags dari struktur OLEUIINSERTOBJECT , OleUIInsertObject memverifikasi bahwa server ada. Jika tidak ada, maka objek server tidak ditambahkan ke daftar objek yang tersedia. Validasi server adalah operasi yang luas waktu dan merupakan faktor performa yang signifikan.

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);
        }
}

Catatan

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

Lihat juga

OLEUIINSERTOBJECT

OpenFile

Bagikan melalui