Bagikan melalui

Struktur ICONINFOEXW (winuser.h)

  • Artikel

Berisi informasi tentang ikon atau kursor. MemperluasICONINFO . Digunakan oleh GetIconInfoEx.

Sintaksis

typedef struct _ICONINFOEXW {
  DWORD   cbSize;
  BOOL    fIcon;
  DWORD   xHotspot;
  DWORD   yHotspot;
  HBITMAP hbmMask;
  HBITMAP hbmColor;
  WORD    wResID;
  WCHAR   szModName[MAX_PATH];
  WCHAR   szResName[MAX_PATH];
} ICONINFOEXW, *PICONINFOEXW;

Anggota

cbSize

Jenis: DWORD

Ukuran, dalam byte, dari struktur ini.

fIcon

Jenis: BOOL

Menentukan apakah struktur ini mendefinisikan ikon atau kursor. Nilai TRUE menentukan ikon; FALSE menentukan kursor.

xHotspot

Jenis: DWORD

Koordinat x dari hot spot kursor. Jika struktur ini mendefinisikan ikon, hot spot selalu berada di tengah ikon, dan anggota ini diabaikan.

yHotspot

Jenis: DWORD

Koordinat y dari titik panas kursor. Jika struktur ini mendefinisikan ikon, hot spot selalu berada di tengah ikon, dan anggota ini diabaikan.

hbmMask

Jenis: HBITMAP

Handel ke masker monokrom ikon bitmap.

hbmColor

Jenis: HBITMAP

Handel ke warna ikon bitmap.

wResID

Jenis: WORD

Pengidentifikasi sumber daya sumber daya dalam modul szModName . Jika ikon atau kursor dimuat berdasarkan nama, maka wResID adalah nol dan szResName berisi nama sumber daya.

Anda dapat menggunakan makro(wResID) MAKEINTRESOURCE untuk mengonversi pengidentifikasi sumber daya ke jenis nama sumber daya yang kompatibel dengan fungsi manajemen sumber daya .

szModName[MAX_PATH]

Jenis: TCHAR[MAX_PATH]

Nama modul tempat ikon atau kursor dimuat.

Anda dapat menggunakan fungsi GetModuleHandle untuk mengonversinya ke handel modul yang kompatibel dengan fungsi manajemen sumber daya .

szResName[MAX_PATH]

Jenis: TCHAR[MAX_PATH]

Nama sumber daya sumber daya dalam modul szModName.

Komentar

Untuk ikon monokrom, hbmMask adalah dua kali tinggi ikon (dengan topeng AND di atas dan masker XOR di bagian bawah), dan hbmColor NULL. Juga, dalam hal ini tingginya harus kelipatan dua kali lipat.

Untuk ikon warna, hbmMask dan hbmColor bitmap berukuran sama, yang masing-masing adalah ukuran ikon.

Anda dapat menggunakan fungsi GetObject untuk mendapatkan konten hbmMask dan hbmColor dalam struktur BITMAP . Bitmap dapat diperoleh dengan panggilan ke GetDIBits pada bitmap dalam struktur ini.

ICONINFOEX adalah versi yang diperluas dari struktur ICONINFO dengan tambahan szModName/szResName/wResID anggota yang dapat digunakan untuk mengkueri ikon atau bit sumber daya kursor. Bit ini biasanya dimuat oleh panggilan ke fungsi FindResource, LoadResource, LockResource dan LookupIconIdFromDirectoryEx.

Nota

Header winuser.h mendefinisikan ICONINFOEX 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 Vista [hanya aplikasi desktop]
server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Header winuser.h (termasuk Windows.h)

Lihat juga

Konseptual

CreateIconIndirect

GeticonInfo

Ikon

Bitmap

GetObject

BITMAP

GetDIBits

Referensi