Struktur OLEUIINSERTOBJECTA (oledlg.h)

Artikel
08/25/2023

Berisi informasi yang digunakan Pustaka Antarmuka Pengguna OLE untuk menginisialisasi kotak dialog Sisipkan Objek , dan ruang bagi pustaka untuk mengembalikan informasi saat kotak dialog ditutup.

Sintaks

typedef struct tagOLEUIINSERTOBJECTA {
  DWORD           cbStruct;
  DWORD           dwFlags;
  HWND            hWndOwner;
  LPCSTR          lpszCaption;
  LPFNOLEUIHOOK   lpfnHook;
  LPARAM          lCustData;
  HINSTANCE       hInstance;
  LPCSTR          lpszTemplate;
  HRSRC           hResource;
  CLSID           clsid;
  LPSTR           lpszFile;
  UINT            cchFile;
  UINT            cClsidExclude;
  LPCLSID         lpClsidExclude;
  IID             iid;
  DWORD           oleRender;
  LPFORMATETC     lpFormatEtc;
  LPOLECLIENTSITE lpIOleClientSite;
  LPSTORAGE       lpIStorage;
  LPVOID          *ppvObj;
  SCODE           sc;
  HGLOBAL         hMetaPict;
} OLEUIINSERTOBJECTA, *POLEUIINSERTOBJECTA, *LPOLEUIINSERTOBJECTA;

Anggota

cbStruct

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

dwFlags

Pada input, menentukan bendera inisialisasi dan pembuatan. Saat keluar, menentukan pilihan pengguna. Ini bisa menjadi kombinasi dari bendera berikut.

Nilai	Makna
IOF_SHOWHELP	Kotak dialog akan menampilkan tombol Bantuan .
IOF_SELECTCREATENEW	Tombol radio Buat Baru awalnya akan diperiksa. Ini tidak dapat digunakan dengan IOF_SELECTCREATEFROMFILE.
IOF_SELECTCREATEFROMFILE	Tombol radio Buat Dari File awalnya akan diperiksa. Ini tidak dapat digunakan dengan IOF_SELECTCREATENEW.
IOF_CHECKLINK	Kotak centang Tautan awalnya akan dicentang.
IOF_CHECKDISPLAYASICON	Kotak centang Tampilkan Sebagai Ikon awalnya akan dicentang, ikon saat ini akan ditampilkan, dan tombol Ubah Ikon akan diaktifkan.
IOF_CREATENEWOBJECT	Objek baru harus dibuat saat pengguna memilih OK untuk menutup kotak dialog dan tombol radio Buat Baru dipilih.
IOF_CREATEFILEOBJECT	Objek baru harus dibuat dari file yang ditentukan saat pengguna memilih OK untuk menutup kotak dialog dan tombol radio Buat Dari File dipilih.
IOF_CREATELINKOBJECT	Objek tertaut baru harus dibuat saat pengguna memilih OK untuk menutup kotak dialog dan pengguna mencentang kotak centang Tautan .
IOF_DISABLELINK	Kotak centang Tautkan akan dinonaktifkan pada inisialisasi.
IOF_VERIFYSERVERSEXIST	Kotak dialog harus memvalidasi kelas yang ditambahkannya ke kotak daftar dengan memastikan bahwa server yang ditentukan dalam database pendaftaran ada. Ini adalah faktor performa yang signifikan.
IOF_DISABLEDISPLAYASICON	Kotak centang Tampilkan Sebagai Ikon akan dinonaktifkan pada inisialisasi.
IOF_HIDECHANGEICON	Tombol Ubah Ikon akan disembunyikan dalam kotak dialog Sisipkan Objek .
IOF_SHOWINSERTCONTROL	Menampilkan tombol radio Sisipkan Kontrol .
IOF_SELECTCREATECONTROL	Menampilkan tombol radio Buat Kontrol .

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 Sisipkan Objek.

lpfnHook

Penunjuk 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 diarahkan oleh anggota lpfnHook . Pustaka meneruskan penunjuk ke struktur OLEUIINSERTOBJECT 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 Sisipkan Objek pustaka.

hResource

Handel templat yang dikustomisasi.

clsid

CLSID untuk kelas objek yang akan disisipkan. Diisi pada output.

lpszFile

Arahkan ke nama file yang akan ditautkan atau disematkan. Diisi pada output.

cchFile

Ukuran buffer lpszFile ; tidak akan melebihi MAX_PATH.

cClsidExclude

Jumlah CLSID yang disertakan dalam daftar lpClsidExclude . Diisi pada input.

lpClsidExclude

Arahkan ke daftar CLSID untuk dikecualikan dari daftar.

iid

Pengidentifikasi antarmuka yang diminta. Jika OleUIInsertObject membuat objek, maka OleUIInsertObject akan mengembalikan pointer ke antarmuka ini. Parameter ini diabaikan jika OleUIInsertObject tidak membuat objek.

oleRender

Opsi penyajian. Jika OleUIInsertObject membuat objek, maka OleUIInsertObject memilih opsi penyajian saat membuat objek. Parameter ini diabaikan jika OleUIInsertObject tidak membuat objek.

lpFormatEtc

Format yang diinginkan. Jika OleUIInsertObject membuat objek, maka OleUIInsertObject memilih format saat membuat objek. Parameter ini diabaikan jika OleUIInsertObject tidak membuat objek.

lpIOleClientSite

Penunjuk ke situs klien yang akan digunakan untuk objek. Parameter ini diabaikan jika OleUIInsertObject tidak membuat objek.

lpIStorage

Arahkan ke penyimpanan yang akan digunakan untuk objek . Parameter ini diabaikan jika OleUIInsertObject tidak membuat objek.

ppvObj

Alamat variabel penunjuk output yang berisi penunjuk antarmuka untuk objek yang sedang disisipkan. Parameter ini diabaikan jika OleUIInsertObject tidak membuat objek.

sc

Hasil panggilan pembuatan. Parameter ini diabaikan jika OleUIInsertObject tidak membuat objek.

hMetaPict

Struktur MetafilePict yang berisi aspek ikonik, jika tidak ditempatkan di cache objek.

Keterangan

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

Lihat juga

OleUIInsertObject

Bagikan melalui