Funzione SetupDiDrawMiniIcon (setupapi.h)
La funzione SetupDiDrawMiniIcon disegna l'icona mini specificata nella posizione richiesta.
Sintassi
WINSETUPAPI INT SetupDiDrawMiniIcon(
[in] HDC hdc,
[in] RECT rc,
[in] INT MiniIconIndex,
[in] DWORD Flags
);
Parametri
[in] hdc
Handle per il contesto del dispositivo in cui verrà disegnata l'icona mini.
[in] rc
Rettangolo nell'handle del contesto di dispositivo specificato per disegnare l'icona mini in.
[in] MiniIconIndex
Indice dell'icona mini, come recuperato da SetupDiLoadClassIcon o SetupDiGetClassBitmapIndex. È possibile usare gli indici predefiniti seguenti per i dispositivi:
| Classe | Indice |
|---|---|
| Computer/sistema | 0 |
| Visualizzazione/monitoraggio | 2 |
| Scheda di rete | 3 |
| Mouse | 5 |
| Tastiera | 6 |
| Suoni | 8 |
| FDC/HDC | 9 |
| Porte | 10 |
| Stampante | 14 |
| Trasporto di rete | 15 |
| Client di rete | 16 |
| Servizio di rete | 17 |
| Sconosciuto | 18 |
[in] Flags
Questi flag controllano l'operazione di disegno. LoWORD contiene i flag effettivi definiti come segue:
DMI_MASK
Disegnare la maschera dell'icona minima in HDC.
DMI_BKCOLOR
Usare l'indice dei colori di sistema specificato nell'hiWORD dei flag come colore di sfondo. Se questo flag non è impostato, viene utilizzato COLOR_WINDOW.
DMI_USERECT
Se impostato, SetupDiDrawMiniIcon usa il rettangolo fornito e estende l'icona per adattarsi.
Valore restituito
Questa funzione restituisce l'offset dal lato sinistro di rc in cui deve iniziare la stringa. Se l'operazione di disegno non riesce, la funzione restituisce zero.
Commenti
Per impostazione predefinita, l'icona viene allineata al centro verticalmente e forzata sul lato sinistro del rettangolo specificato.
SetupDiDrawMiniIcon disegna la versione a 16 bit dell'icona specificata dal parametro MiniIconIndex . Anziché SetupDiDrawMiniIcon, devi usare SetupDiLoadClassIcon insieme a DrawIcon o DrawIconEx per disegnare la versione a 32 bit dell'icona. Di seguito è riportato un esempio di come usare DrawIconEx per visualizzare un'icona:
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);
}
Per altre informazioni su DrawIcon o DrawIconEx, vedere la documentazione di Microsoft Windows Software Development Kit (SDK) per Windows 7 e .NET Framework 4.0.
Requisiti
| Client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | setupapi.h (include Setupapi.h) |
| Libreria | Setupapi.lib |
| DLL | Setupapi.dll |