IExtractIconW::Metode ekstrak (shlobj_core.h)

Artikel
08/26/2023

Mengekstrak gambar ikon dari lokasi yang ditentukan.

Sintaks

HRESULT Extract(
  [in]            PCWSTR pszFile,
                  UINT   nIconIndex,
  [out, optional] HICON  *phiconLarge,
  [out, optional] HICON  *phiconSmall,
                  UINT   nIconSize
);

Parameter

[in] pszFile

Jenis: PCTSTR

Penunjuk ke string yang dihentikan null yang menentukan lokasi ikon.

nIconIndex

Jenis: UINT

Indeks ikon dalam file yang ditujukan oleh pszFile.

[out, optional] phiconLarge

Jenis: HICON*

Penunjuk ke nilai HICON yang menerima handel ke ikon besar. Parameter ini mungkin NULL.

[out, optional] phiconSmall

Jenis: HICON*

Penunjuk ke nilai HICON yang menerima handel ke ikon kecil. Parameter ini mungkin NULL.

nIconSize

Jenis: UINT

Ukuran ikon yang diinginkan, dalam piksel. Kata rendah berisi ukuran ikon besar, dan kata tinggi berisi ukuran ikon kecil. Ukuran yang ditentukan bisa berupa lebar atau tinggi. Lebar ikon selalu sama dengan tingginya.

Menampilkan nilai

Jenis: HRESULT

Mengembalikan S_OK jika fungsi mengekstrak ikon, atau S_FALSE jika aplikasi panggilan harus mengekstrak ikon.

Keterangan

Lokasi ikon dan indeks adalah nilai yang sama yang dikembalikan oleh metode IExtractIcon::GetIconLocation . Jika fungsi IExtractIcon::Extract mengembalikan S_FALSE, nilai-nilai ini harus menentukan nama file ikon dan indeks yang membentuk parameter hukum untuk panggilan ke ExtractIcon. Jika IExtractIcon::Extract tidak mengembalikan S_FALSE, tidak ada asumsi yang harus dibuat tentang arti parameter pszFile dan nIconIndex .

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj_core.h
DLL	Shell32.dll (versi 4.0 atau yang lebih baru)

Lihat juga

IExtractIcon

Bagikan melalui