Fungsi GetIconInfo (winuser.h)

Artikel
03/04/2024

Mengambil informasi tentang ikon atau kursor yang ditentukan.

Sintaks

BOOL GetIconInfo(
  [in]  HICON     hIcon,
  [out] PICONINFO piconinfo
);

Parameter

[in] hIcon

Jenis: HICON

Handel ke ikon atau kursor.

Untuk mengambil informasi tentang ikon standar atau kursor, tentukan pengidentifikasi yang dimulai dengan awalan IDI_ atau pengidentifikasi yang dimulai dengan awalan IDC_ dalam parameter ini.

[out] piconinfo

Jenis: PICONINFO

Penunjuk ke struktur ICONINFO . Fungsi ini mengisi anggota struktur.

Nilai kembali

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol dan fungsi mengisi anggota struktur ICONINFO yang ditentukan.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

GetIconInfo membuat bitmap untuk hbmMask dan hbmColor atau anggota ICONINFO. Aplikasi panggilan harus mengelola bitmap ini dan menghapusnya dengan panggilan DeleteObject ketika tidak lagi diperlukan.

Virtualisasi DPI

API ini tidak berpartisipasi dalam virtualisasi DPI. Output yang dikembalikan tidak terpengaruh oleh DPI dari utas panggilan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-gui-l1-1-0 (diperkenalkan dalam Windows 8)