Fungsi LoadIconWithScaleDown (commctrl.h)

Artikel
03/04/2024

Memuat ikon. Jika ikon bukan ukuran standar, fungsi ini menurunkan skala gambar yang lebih besar alih-alih meningkatkan gambar yang lebih kecil.

Sintaks

HRESULT LoadIconWithScaleDown(
  [in]  HINSTANCE hinst,
  [in]  PCWSTR    pszName,
  [in]  int       cx,
  [in]  int       cy,
  [out] HICON     *phico
);

Parameter

[in] hinst

Jenis: HINSTANCE

Handel ke modul file DLL atau file yang dapat dieksekusi (.exe) yang berisi ikon yang akan dimuat. Untuk informasi selengkapnya, lihat GetModuleHandle.

Untuk memuat ikon sistem yang telah ditentukan sebelumnya atau file ikon mandiri, atur parameter ini ke NULL.

[in] pszName

Jenis: PCWSTR

Penunjuk ke buffer Unicode yang dihentikan null yang berisi informasi lokasi tentang ikon yang akan dimuat.

Jika hinst bukan NULL, pszName menentukan sumber daya ikon baik berdasarkan nama atau ordinal. Ordinal ini harus dikemas dengan menggunakan makro MAKEINTRESOURCE .

Jika hinst adalah NULL, pszName menentukan pengidentifikasi (dimulai dengan awalan IDI_) dari ikon sistem yang telah ditentukan sebelumnya untuk dimuat.

[in] cx

Jenis: int

Lebar yang diinginkan, dalam piksel, ikon.

[in] cy

Jenis: int

Tinggi yang diinginkan, dalam piksel, ikon.

[out] phico

Jenis: HICON*

Saat fungsi ini kembali, berisi penunjuk ke handel ikon yang dimuat.

Mengembalikan nilai

Jenis: HRESULT

Mengembalikan S_OK jika berhasil, atau nilai kesalahan jika tidak, termasuk yang berikut ini:

Menampilkan kode	Deskripsi
E_INVALIDARG	Konten buffer yang ditujukkan oleh pszName tidak sesuai dengan interpretasi yang diharapkan.

Keterangan

Fungsi ini pertama-tama akan mencari file ikon untuk ikon yang memiliki ukuran yang sama persis. Jika kecocokan tidak ditemukan, maka kecuali jika cx dan cy cocok dengan salah satu ukuran ikon standar—16, 32, 48, atau 256 piksel— ikon terbesar berikutnya dipilih lalu diturunkan skalanya ke ukuran yang diinginkan. Misalnya, jika ikon dengan dimensi x 40 piksel diminta oleh aplikasi callign, ikon 48 piksel digunakan dan diturunkan skalanya menjadi 40 piksel. Sebaliknya, fungsi LoadImage memilih ikon 32 piksel dan menskalakannya hingga 40 piksel.

Jika fungsi tidak dapat menemukan ikon yang lebih besar, fungsi tersebut default ke perilaku standar untuk menemukan ikon terkecil berikutnya dan menskalakannya hingga ukuran yang diinginkan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	commctrl.h
Pustaka	Comctl32.lib
DLL	Comctl32.dll

Bagikan melalui