Fungsi SetupDiDrawMiniIcon (setupapi.h)

  • Artikel

Fungsi SetupDiDrawMiniIcon menggambar ikon mini yang ditentukan di lokasi yang diminta.

Sintaks

WINSETUPAPI INT SetupDiDrawMiniIcon(
  [in] HDC   hdc,
  [in] RECT  rc,
  [in] INT   MiniIconIndex,
  [in] DWORD Flags
);

Parameter

[in] hdc

Handel ke konteks perangkat tempat ikon mini akan digambar.

[in] rc

Persegi panjang dalam handel konteks perangkat yang ditentukan untuk menggambar ikon mini.

[in] MiniIconIndex

Indeks ikon mini, seperti yang diambil dari SetupDiLoadClassIcon atau SetupDiGetClassBitmapIndex. Indeks yang telah ditentukan sebelumnya berikut untuk perangkat dapat digunakan:

Kelas Indeks
Komputer/Sistem 0
Tampilkan/Pantau 2
Adapter Jaringan 3
Mouse 5
Keyboard 6
Suarakan 8
FDC/HDC 9
Port 10
Printer 14
Transportasi Jaringan 15
Klien Jaringan 16
Layanan Jaringan 17
Tidak dikenal 18

[in] Flags

Bendera ini mengontrol operasi menggambar. LOWORD berisi bendera aktual yang didefinisikan sebagai berikut:

DMI_MASK

Gambar masker ikon mini ke HDC.

DMI_BKCOLOR

Gunakan indeks warna sistem yang ditentukan dalam HIWORD Bendera sebagai warna latar belakang. Jika bendera ini tidak diatur, COLOR_WINDOW digunakan.

DMI_USERECT

Jika diatur, SetupDiDrawMiniIcon menggunakan persegi panjang yang disediakan dan membentangkan ikon agar pas.

Menampilkan nilai

Fungsi ini mengembalikan offset dari sisi kiri rc tempat string harus dimulai. Jika operasi gambar gagal, fungsi mengembalikan nol.

Keterangan

Secara default, ikon dipusatkan secara vertikal dan dipaksa terhadap sisi kiri persegi panjang yang ditentukan.

SetupDiDrawMiniIcon menggambar ikon versi 16-bit yang ditentukan oleh parameter MiniIconIndex . Alih-alih SetupDiDrawMiniIcon, Anda harus menggunakan SetupDiLoadClassIcon bersama dengan DrawIcon atau DrawIconEx untuk menggambar ikon versi 32-bit. Berikut ini adalah contoh cara menggunakan DrawIconEx untuk menampilkan ikon:

HICON hIcon;

if (SetupDiLoadClassIcon(&GUID_DEVCLASS_USB, &hIcon, NULL)) {
    DrawIconEx(hDC, 0, 0, hIcon, GetSystemMetrics(SM_CXSMICON),GetSystemMetrics(SM_CYSMICON), 0, NULL, DI_NORMAL); 
DestroyIcon(hIcon);
}

Untuk informasi selengkapnya tentang DrawIcon atau DrawIconEx, lihat dokumentasi Microsoft Windows Software Development Kit (SDK) untuk Windows 7 dan .NET Framework 4.0.

Persyaratan

   
Klien minimum yang didukung Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru.
Target Platform Desktop
Header setupapi.h (termasuk Setupapi.h)
Pustaka Setupapi.lib
DLL Setupapi.dll

Lihat juga

SetupDiGetClassBitmapIndex

SetupDiLoadClassIcon