SetupDiDrawMiniIcon-Funktion (setupapi.h)

  • Artikel

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

Weitere Informationen

SetupDiGetClassBitmapIndex

SetupDiLoadClassIcon