SetupDiDrawMiniIcon, fonction (setupapi.h)

Article
08/26/2023

La fonction SetupDiDrawMiniIcon dessine la mini-icône spécifiée à l’emplacement demandé.

Syntaxe

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

Paramètres

[in] hdc

Handle du contexte de l’appareil dans lequel la mini-icône sera dessinée.

[in] rc

Rectangle dans le handle de contexte d’appareil spécifié dans lequel dessiner la mini-icône.

[in] MiniIconIndex

Index de la mini-icône, tel que récupéré à partir de SetupDiLoadClassIcon ou SetupDiGetClassBitmapIndex. Les index prédéfinis suivants pour les appareils peuvent être utilisés :

Classe	Index
Ordinateur/système	0
Afficher/Surveiller	2
Carte réseau	3
Souris	5
Clavier	6
Son	8
FDC/HDC	9
Ports	10
Imprimante	14
Transport réseau	15
Client réseau	16
Service réseau	17
Unknown	18

[in] Flags

Ces indicateurs contrôlent l’opération de dessin. Le LOWORD contient les indicateurs réels définis comme suit :

DMI_MASK

Dessinez le masque de la mini-icône dans HDC.

DMI_BKCOLOR

Utilisez l’index de couleur système spécifié dans hiword d’indicateurs comme couleur d’arrière-plan. Si cet indicateur n’est pas défini, COLOR_WINDOW est utilisé.

DMI_USERECT

Si la valeur est définie, SetupDiDrawMiniIcon utilise le rectangle fourni et étire l’icône pour l’ajuster.

Valeur retournée

Cette fonction retourne le décalage à partir du côté gauche de rc où la chaîne doit commencer. Si l’opération de dessin échoue, la fonction retourne zéro.

Remarques

Par défaut, l’icône est centrée verticalement et forcée sur le côté gauche du rectangle spécifié.

SetupDiDrawMiniIcon dessine la version 16 bits de l’icône spécifiée par le paramètre MiniIconIndex . Au lieu de SetupDiDrawMiniIcon, vous devez utiliser SetupDiLoadClassIcon avec DrawIcon ou DrawIconEx pour dessiner la version 32 bits de l’icône. Voici un exemple d’utilisation de DrawIconEx pour afficher une icône :

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);
}

Pour plus d’informations sur DrawIcon ou DrawIconEx, reportez-vous à la documentation du Kit de développement logiciel (SDK) Microsoft Windows pour Windows 7 et .NET Framework 4.0.

Configuration requise


Client minimal pris en charge	Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
Plateforme cible	Bureau
En-tête	setupapi.h (inclure Setupapi.h)
Bibliothèque	Setupapi.lib
DLL	Setupapi.dll

Voir aussi

SetupDiGetClassBitmapIndex

SetupDiLoadClassIcon

Partager via