SetupDiDrawMiniIcon-Funktion (setupapi.h)
Die SetupDiDrawMiniIcon-Funktion zeichnet das angegebene Minisymbol an der angeforderten Position.
Syntax
WINSETUPAPI INT SetupDiDrawMiniIcon(
[in] HDC hdc,
[in] RECT rc,
[in] INT MiniIconIndex,
[in] DWORD Flags
);
Parameter
[in] hdc
Das Handle für den Gerätekontext, in dem das Minisymbol gezeichnet wird.
[in] rc
Das Rechteck im angegebenen Gerätekontexthandle zum Zeichnen des Minisymbols.
[in] MiniIconIndex
Der Index des Minisymbols, wie er von SetupDiLoadClassIcon oder SetupDiGetClassBitmapIndex abgerufen wird. Die folgenden vordefinierten Indizes für Geräte können verwendet werden:
| Klasse | Index |
|---|---|
| Computer/System | 0 |
| Anzeige/Monitor | 2 |
| Netzwerkkarte | 3 |
| Maus | 5 |
| Tastatur | 6 |
| Sound | 8 |
| FDC/HDC | 9 |
| Ports | 10 |
| Drucker | 14 |
| Netzwerktransport | 15 |
| Netzwerkclient | 16 |
| Netzwerkdienst | 17 |
| Unbekannt | 18 |
[in] Flags
Diese Flags steuern den Zeichnungsvorgang. LOWORD enthält die tatsächlichen Flags, die wie folgt definiert sind:
DMI_MASK
Zeichnen Sie die Maske des Minisymbols in HDC.
DMI_BKCOLOR
Verwenden Sie den im HIWORD von Flags angegebenen Systemfarbindex als Hintergrundfarbe. Wenn dieses Flag nicht festgelegt ist, wird COLOR_WINDOW verwendet.
DMI_USERECT
Wenn festgelegt, verwendet SetupDiDrawMiniIcon das angegebene Rechteck und streckt das Symbol so, dass es passt.
Rückgabewert
Diese Funktion gibt den Offset von der linken Seite von rc zurück, wo die Zeichenfolge beginnen soll. Wenn der Zeichnungsvorgang fehlschlägt, gibt die Funktion null zurück.
Hinweise
Standardmäßig wird das Symbol vertikal zentriert und auf der linken Seite des angegebenen Rechtecks erzwungen.
SetupDiDrawMiniIcon zeichnet die 16-Bit-Version des Symbols, das durch den MiniIconIndex-Parameter angegeben wird. Anstelle von SetupDiDrawMiniIcon sollten Sie SetupDiLoadClassIcon zusammen mit DrawIcon oder DrawIconEx verwenden, um die 32-Bit-Version des Symbols zu zeichnen. Im Folgenden finden Sie ein Beispiel für die Verwendung von DrawIconEx zum Anzeigen eines Symbols:
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);
}
Weitere Informationen zu DrawIcon oder DrawIconEx finden Sie in der Dokumentation microsoft Windows Software Development Kit (SDK) für Windows 7 und .NET Framework 4.0.
Anforderungen
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | setupapi.h (schließen Sie Setupapi.h ein) |
| Bibliothek | Setupapi.lib |
| DLL | Setupapi.dll |