Fungsi OleUIInsertObjectA (oledlg.h)
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 |
---|---|
|
Kegagalan tidak diketahui (tidak digunakan). |
|
Pengguna menekan tombol OK. |
|
Tidak ada kesalahan, sama seperti OLEUI_OK. |
|
Pengguna menekan tombol Batalkan. |
Kesalahan Validasi Bidang Standar
Menampilkan kode | Deskripsi |
---|---|
|
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. |
|
Penunjuk ke struktur OLEUIXXX yang diteruskan ke fungsi adalah NULL. |
|
Izin untuk akses baca atau tulis ke struktur OLEUIXXX tidak cukup. |
|
Nilai cbstruct salah. |
|
Nilai hWndOwner tidak valid. |
|
Nilai lpszCaption tidak valid. |
|
Nilai lpfnHook tidak valid. |
|
Nilai hInstance tidak valid. |
|
Nilai lpszTemplate tidak valid. |
|
Nilai hResource tidak valid. |
Kesalahan Inisialisasi
Menampilkan kode | Deskripsi |
---|---|
|
Tidak dapat menemukan templat kotak dialog. |
|
Tidak dapat memuat templat kotak dialog. |
|
Inisialisasi kotak dialog gagal. |
|
Panggilan ke LocalAlloc atau alokator IMalloc standar gagal. |
|
Panggilan ke GlobalAlloc atau alokator IMalloc standar gagal. |
|
Tidak dapat memanggil LoadString untuk sumber daya yang dilokalkan dari pustaka. |
|
Panggilan ke alokator IMalloc standar gagal. |
Kesalahan Spesifik Fungsi
Menampilkan kode | Deskripsi |
---|---|
|
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. |
|
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. |
|
Nilai ppvOjb tidak valid. Anggota ini menunjuk ke lokasi tempat penunjuk untuk objek dikembalikan. |
|
Nilai lpIOleClientSite tidak valid. Anggota ini menunjuk ke situs klien untuk objek tersebut. |
|
Nilai lpIStorage tidak valid. Anggota ini menunjuk ke penyimpanan yang akan digunakan untuk objek . |
|
Anggota scdari lpIO memiliki informasi kesalahan tambahan. |
|
Nilai lpClsidExclude tidak valid. Anggota ini berisi daftar CLSID yang akan dikecualikan. |
|
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).
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->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 |