Fungsi DrawIconEx (winuser.h)

Artikel
03/04/2024

Menggambar ikon atau kursor ke dalam konteks perangkat yang ditentukan, melakukan operasi raster yang ditentukan, dan meregangkan atau mengompresi ikon atau kursor seperti yang ditentukan.

Sintaks

BOOL DrawIconEx(
  [in]           HDC    hdc,
  [in]           int    xLeft,
  [in]           int    yTop,
  [in]           HICON  hIcon,
  [in]           int    cxWidth,
  [in]           int    cyWidth,
  [in]           UINT   istepIfAniCur,
  [in, optional] HBRUSH hbrFlickerFreeDraw,
  [in]           UINT   diFlags
);

Parameter

[in] hdc

Jenis: HDC

Handel ke konteks perangkat tempat ikon atau kursor akan digambar.

[in] xLeft

Jenis: int

Koordinat x logis sudut kiri atas ikon atau kursor.

[in] yTop

Jenis: int

Koordinat y logis dari sudut kiri atas ikon atau kursor.

[in] hIcon

Jenis: HICON

Handel ke ikon atau kursor yang akan digambar. Parameter ini dapat mengidentifikasi kursor animasi.

[in] cxWidth

Jenis: int

Lebar logis ikon atau kursor. Jika parameter ini nol dan parameter diFlagsDI_DEFAULTSIZE, fungsi menggunakan nilai metrik sistem SM_CXICON untuk mengatur lebar. Jika parameter ini nol dan DI_DEFAULTSIZE tidak digunakan, fungsi menggunakan lebar sumber daya aktual.

[in] cyWidth

Jenis: int

Tinggi logis ikon atau kursor. Jika parameter ini nol dan parameter diFlagsDI_DEFAULTSIZE, fungsi menggunakan nilai metrik sistem SM_CYICON untuk mengatur lebar. Jika parameter ini nol dan DI_DEFAULTSIZE tidak digunakan, fungsi menggunakan tinggi sumber daya aktual.

[in] istepIfAniCur

Jenis: UINT

Indeks bingkai yang akan digambar, jika hIcon mengidentifikasi kursor animasi. Parameter ini diabaikan jika hIcon tidak mengidentifikasi kursor animasi.

[in, optional] hbrFlickerFreeDraw

Jenis: HBRUSH

Pegangan ke kuas yang digunakan sistem untuk menggambar bebas kedinginan. Jika hbrFlickerFreeDraw adalah handel kuas yang valid, sistem membuat bitmap di luar layar menggunakan kuas yang ditentukan untuk warna latar belakang, menggambar ikon atau kursor ke bitmap, lalu menyalin bitmap ke dalam konteks perangkat yang diidentifikasi oleh hdc. Jika hbrFlickerFreeDrawADALAH NULL, sistem akan menarik ikon atau kursor langsung ke konteks perangkat.

[in] diFlags

Jenis: UINT

Bendera gambar. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
DI_COMPAT 0x0004	Bendera ini diabaikan.
DI_DEFAULTSIZE 0x0008	Menggambar ikon atau kursor menggunakan lebar dan tinggi yang ditentukan oleh nilai metrik sistem untuk ikon, jika parameter cxWidth dan cyWidth diatur ke nol. Jika bendera ini tidak ditentukan dan cxWidth dan cyWidth diatur ke nol, fungsi menggunakan ukuran sumber daya aktual.
DI_IMAGE 0x0002	Menggambar ikon atau kursor menggunakan gambar. Lihat Keterangan.
DI_MASK 0x0001	Menggambar ikon atau kursor menggunakan masker. Lihat Keterangan.
DI_NOMIRROR 0x0010	Menggambar ikon sebagai ikon yang tidak disarankan. Secara default, ikon digambar sebagai ikon cermin jika hdc dicerminkan.
DI_NORMAL 0x0003	Kombinasi DI_IMAGE dan DI_MASK. Lihat Keterangan.

Nilai kembali

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

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

Keterangan

Fungsi DrawIconEx menempatkan sudut kiri atas ikon di lokasi yang ditentukan oleh parameter xLeft dan yTop . Lokasi tunduk pada mode pemetaan saat ini dari konteks perangkat.

Jika hanya salah satu bendera DI_IMAGE dan DI_MASK yang diatur, maka bitmap yang sesuai digambar dengan kode operasi rasterSRCCOPY.

Jika bendera DI_IMAGE dan DI_MASK diatur:

Jika ikon atau kursor adalah ikon atau kursor 32-bit alpha-blended, maka gambar digambar dengan fungsi campuranAC_SRC_OVER dan masker diabaikan.
Untuk semua ikon atau kursor lainnya, masker digambar dengan kode operasi rasterSRCAND, dan gambar digambar dengan kode operasi rasterSRCINVERT

Untuk menduplikasi DrawIcon (hDC, X, Y, hIcon), panggil DrawIconEx sebagai berikut:

DrawIconEx (hDC, X, Y, hIcon, 0, 0, 0, NULL, DI_NORMAL | DI_COMPAT | DI_DEFAULTSIZE);

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
Set API	ext-ms-win-ntuser-gui-l1-1-0 (diperkenalkan dalam Windows 8)