Fungsi CreateIcon (winuser.h)
Membuat ikon yang memiliki ukuran, warna, dan pola bit yang ditentukan.
Untuk membuat ikon berwarna pada durasi, Anda dapat menggunakan fungsi CreateIconIndirect , yang membuat ikon berdasarkan konten struktur ICONINFO .
Sintaks
HICON CreateIcon(
[in, optional] HINSTANCE hInstance,
[in] int nWidth,
[in] int nHeight,
[in] BYTE cPlanes,
[in] BYTE cBitsPixel,
[in] const BYTE *lpbANDbits,
[in] const BYTE *lpbXORbits
);
Parameter
[in, optional] hInstance
Jenis: HINSTANCE
Handel ke instans modul yang membuat ikon.
[in] nWidth
Jenis: int
Lebar, dalam piksel, ikon. Lihat keterangan.
[in] nHeight
Jenis: int
Tinggi, dalam piksel, ikon. Lihat keterangan.
[in] cPlanes
Jenis: BYTE
Jumlah bidang di bitmask XOR ikon. Lihat keterangan.
[in] cBitsPixel
Jenis: BYTE
Jumlah bit per piksel di bitmask XOR ikon.
[in] lpbANDbits
Jenis: const BYTE*
Array byte yang berisi nilai bit untuk bitmask AND ikon. Bitmask ini menjelaskan bitmap monokrom. Lihat keterangan.
[in] lpbXORbits
Jenis: const BYTE*
Array byte yang berisi nilai bit untuk bitmask XOR ikon. Bitmask ini menjelaskan bitmap monokrom atau warna. Lihat keterangan.
Mengembalikan nilai
Jenis: HICON
Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke ikon.
Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Untuk menentukan ukuran nominal ikon, gunakan fungsi GetSystemMetrics , menentukan nilai SM_CXICON atau SM_CYICON . Selain itu, Anda dapat menggunakan versi API yang sadar DPI, lihat (GetSystemMetricsForDpi)(/windows/win32/api/winuser/nf-winuser-getsystemmetricsfordpi). Untuk informasi selengkapnya lihat Ukuran Ikon dan Pengembangan Aplikasi Desktop DPI Tinggi di Windows.
Untuk informasi selengkapnya tentang parameter lpbANDbits dan lpbXORbits lihat deskripsi parameter lpBits dari fungsi CreateBitmap .
Dalam kasus ikon monokrom CreateIcon menerapkan tabel kebenaran berikut ke bitmasks AND dan XOR:
| BITMASK AND | Bitmask XOR | Tampilan |
|---|---|---|
| 0 | 0 | Hitam |
| 0 | 1 | Putih |
| 1 | 0 | Layar |
| 1 | 1 | Layar terbalik |
Ketika Anda selesai menggunakan ikon , hancurkan menggunakan fungsi DestroyIcon .
Contoh
Misalnya, lihat Membuat Ikon.
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 (termasuk Windows.h) |
| Pustaka | User32.lib |
| DLL | User32.dll |