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

Lihat juga

CreateIconIndirect

Ikon

Ukuran Ikon