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:

[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

Vedi anche

SetupDiGetClassBitmapIndex

SetupDiLoadClassIcon