Bagikan melalui

Fungsi OleUIConvertA (oledlg.h)

  • Artikel

Memanggil kotak dialog Mengonversi standar, memungkinkan pengguna mengubah jenis objek tertentu tunggal, atau tipe semua objek OLE dari kelas objek yang ditentukan.

Sintaksis

UINT OleUIConvertA(
  [in] LPOLEUICONVERTA unnamedParam1
);

Parameter

[in] unnamedParam1

Penunjuk ke struktur OLEUICONVERT yang berisi informasi yang digunakan untuk menginisialisasi kotak dialog.

Mengembalikan nilai

Definisi Keberhasilan/Kesalahan Standar

Mengembalikan 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

Mengembalikan 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 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

Mengembalikan 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

Mengembalikan 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_CTERR_CLASSIDINVALID
 Nilai clsid tidak valid.
OLEUI_CTERR_DVASPECTINVALID
 Nilai dvAspect tidak valid. Anggota ini menentukan aspek objek.
OLEUI_CTERR_CBFORMATINVALID
 Nilai wFormat tidak valid. Anggota ini menentukan format data objek.
OLEUI_CTERR_STRINGINVALID
 Nilai string (misalnya, lpszUserType atau lpszDefLabel) tidak valid.

Komentar

OleUIConvert mengisi kotak daftar kotak dialog Konversi dengan kelas objek dengan melintasi registri dan mencari entri dalam kunci Yang Dapat Dibaca dan Dapat Dibaca. Setiap kelas yang menyertakan format file default kelas asli dalam kunci Yang Dapat Dibaca ditambahkan ke daftar Konversi, dan setiap kelas yang menyertakan format file default kelas asli dalam kunci ReadWritable-nya ditambahkan ke daftar Aktifkan Sebagai. Daftar Konversi diperlihatkan dalam kotak daftar kotak dialog saat tombol radio Konversi dipilih (pilihan default), dan daftar Aktifkan Sebagai ditampilkan saat Aktifkan Sebagai dipilih.

Perhatikan bahwa Anda dapat mengubah jenis semua objek kelas tertentu hanya saat CF_CONVERTONLY tidak ditentukan.

Perintah konversi, yang memanggil fungsi ini, hanya boleh disediakan untuk pengguna jika OleUICanConvertOrActivateAs mengembalikan S_OK.

Nota

Header oledlg.h mendefinisikan OLEUICONVERT 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

Syarat Nilai
klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Platform Target Windows
Header oledlg.h
Pustaka OleDlg.lib
DLL OleDlg.dll

Lihat juga

OLEUICONVERT

OleUICanConvertOrActivateAs