Struktur ICONINFOEXA (winuser.h)

Artikel
03/04/2024

Berisi informasi tentang ikon atau kursor. Memperluas ICONINFO. Digunakan oleh GetIconInfoEx.

Sintaks

typedef struct _ICONINFOEXA {
  DWORD   cbSize;
  BOOL    fIcon;
  DWORD   xHotspot;
  DWORD   yHotspot;
  HBITMAP hbmMask;
  HBITMAP hbmColor;
  WORD    wResID;
  CHAR    szModName[MAX_PATH];
  CHAR    szResName[MAX_PATH];
} ICONINFOEXA, *PICONINFOEXA;

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 hot spot kursor. Jika struktur ini mendefinisikan ikon, hot spot selalu berada di tengah ikon, dan anggota ini diabaikan.

hbmMask

Jenis: HBITMAP

Handel ke ikon bitmap mask monokrom.

hbmColor

Jenis: HBITMAP

Handel ke bitmap warna ikon.

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 MAKEINTRESOURCE(wResID) 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 .

Keterangan

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

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

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

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

Catatan

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