Struktur OLEUICHANGEICONW (oledlg.h)

Artikel
03/15/2023

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

Sintaks

typedef struct tagOLEUICHANGEICONW {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCWSTR       lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCWSTR       lpszTemplate;
  HRSRC         hResource;
  HGLOBAL       hMetaPict;
  CLSID         clsid;
  WCHAR         szIconExe[MAX_PATH];
  int           cchIconExe;
} OLEUICHANGEICONW, *POLEUICHANGEICONW, *LPOLEUICHANGEICONW;

Anggota

cbStruct

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

dwFlags

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

Nilai	Makna
CIF_SHOWHELP	Kotak dialog akan menampilkan tombol Bantuan .
CIF_SELECTCURRENT	Pada input, pilih tombol radio Saat ini pada inisialisasi. Saat keluar, menentukan bahwa pengguna memilih Saat Ini.
CIF_SELECTDEFAULT	Pada input, pilih tombol radio Default pada inisialisasi. Saat keluar, menentukan bahwa pengguna memilih Default.
CIF_SELECTFROMFILE	Pada input, pilih tombol radio Dari File pada inisialisasi. Saat keluar, menentukan bahwa pengguna memilih Dari File.
CIF_USEICONEXE	Input saja. Mengekstrak ikon dari executable yang ditentukan dalam anggota szIconExe , alih-alih mengambilnya dari kelas . Ini berguna untuk penyematan OLE atau penautan ke file non-OLE.

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 Ubah Ikon.

lpfnHook

Arahkan 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 ditujukkan oleh anggota lpfnHook . Pustaka meneruskan penunjuk ke struktur OLEUICHANGEICON 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 Ubah Ikon pustaka.

hResource

Handel templat yang dikustomisasi.

hMetaPict

Gambar saat ini dan terakhir. Sumber ikon disematkan dalam metafile itu sendiri.

clsid

Input saja. Kelas yang digunakan untuk mendapatkan ikon Default .

szIconExe[MAX_PATH]

Input saja. Arahkan ke executable untuk mengekstrak ikon default. Anggota ini diabaikan kecuali CIF_USEICONEXE disertakan dalam anggota dwFlags dan upaya untuk mengambil ikon kelas dari CLSID yang ditentukan gagal.

cchIconExe

Input saja. Jumlah karakter dalam szIconExe. Anggota ini diabaikan kecuali CIF_USEICONEXE disertakan dalam anggota dwFlags .

Keterangan

Catatan

Header oledlg.h mendefinisikan OLEUICHANGEICON 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 10 Build 20348
Server minimum yang didukung	Windows 10 Build 20348
Header	oledlg.h

Bagikan melalui