Fungsi SHGetStockIconInfo (shellapi.h)

Artikel
03/15/2023

Mengambil informasi tentang ikon Shell yang ditentukan sistem.

Sintaks

SHSTDAPI SHGetStockIconInfo(
            SHSTOCKICONID   siid,
            UINT            uFlags,
  [in, out] SHSTOCKICONINFO *psii
);

Parameter

siid

Jenis: SHSTOCKICONID

Salah satu nilai dari enumerasi SHSTOCKICONID yang menentukan ikon mana yang harus diambil.

uFlags

Jenis: UINT

Kombinasi nol atau beberapa bendera berikut yang menentukan informasi mana yang diminta.

SHGSI_ICONLOCATION

Anggota szPath dan iIcon dari struktur SHSTOCKICONINFO menerima jalur dan indeks ikon ikon yang diminta, dalam format yang cocok untuk diteruskan ke fungsi ExtractIcon . Nilai numerik bendera ini adalah nol, sehingga Anda selalu mendapatkan lokasi ikon terlepas dari bendera lain.

SHGSI_ICON

Anggota hIcon dari struktur SHSTOCKICONINFO menerima handel ke ikon yang ditentukan.

SHGSI_SYSICONINDEX

Anggota iSysImageImage dari struktur SHSTOCKICONINFO menerima indeks ikon yang ditentukan dalam daftar gambar sistem.

SHGSI_LINKOVERLAY

Memodifikasi nilai SHGSI_ICON dengan menyebabkan fungsi menambahkan overlay tautan ke ikon file.

SHGSI_SELECTED

Memodifikasi nilai SHGSI_ICON dengan menyebabkan fungsi memadukan ikon dengan warna sorotan sistem.

SHGSI_LARGEICON

Memodifikasi nilai SHGSI_ICON dengan menyebabkan fungsi mengambil versi besar ikon, seperti yang ditentukan oleh metrik sistem SM_CXICON dan SM_CYICON.

SHGSI_SMALLICON

Memodifikasi nilai SHGSI_ICON dengan menyebabkan fungsi mengambil versi kecil ikon, seperti yang ditentukan oleh metrik sistem SM_CXSMICON dan SM_CYSMICON.

SHGSI_SHELLICONSIZE

Memodifikasi nilai SHGSI_LARGEICON atau SHGSI_SMALLICON dengan menyebabkan fungsi mengambil ikon berukuran Shell daripada ukuran yang ditentukan oleh metrik sistem.

[in, out] psii

Jenis: SHSTOCKICONINFO*

Penunjuk ke struktur SHSTOCKICONINFO . Ketika fungsi ini dipanggil, anggota cbSize dari struktur ini perlu diatur ke ukuran struktur SHSTOCKICONINFO . Ketika fungsi ini kembali, berisi penunjuk ke struktur SHSTOCKICONINFO yang berisi informasi yang diminta.

Mengembalikan nilai

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Jika fungsi ini mengembalikan handel ikon di anggota hIcon struktur SHSTOCKICONINFO yang ditujukan oleh psii, Anda bertanggung jawab untuk membebaskan ikon dengan DestroyIcon ketika Anda tidak lagi membutuhkannya.

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	shellapi.h
DLL	Shell32.dll
Set API	ext-ms-win-shell-shell32-l1-2-1 (diperkenalkan dalam Windows 10, versi 10.0.10240)

Bagikan melalui