SHExtractIconsW fonction)
[SHExtractIconsW est disponible via Windows XP Service Pack 2 (SP2). Il peut être modifié ou non disponible dans les versions ultérieures.]
Crée un tableau de handles pour les icônes extraites d’un fichier spécifié.
Syntaxe
UINT SHExtractIconsW(
_In_ LPCWSTR pszFileName,
_In_ int nIconIndex,
_In_ int cxIcon,
_In_ int cyIcon,
_Out_ HICON *phIcon,
_Out_ UINT *pIconId,
_In_ UINT nIcons,
_In_ UINT flags
);
Paramètres
-
pszFileName [ dans]
-
Type : LPCWSTR
Pointeur vers le nom de fichier à partir duquel extraire les icônes.
-
nIconIndex [ dans]
-
Type : int
Index de la première icône à extraire de la ressource nommée dans pszFileName.
-
cxIcon [ dans]
-
Type : int
Largeur souhaitée de l’icône. Consultez la section Notes.
-
cyIcon [ dans]
-
Type : int
Hauteur souhaitée de l’icône. Consultez la section Notes.
-
phIcon [ à]
-
Type : HICON *
Lorsque cette fonction est retournée, contient un pointeur vers le tableau de handles d’icône.
-
pIconId [ à]
-
Type : uint *
Lorsque cette fonction est retournée, contient un pointeur vers l’identificateur de ressource de l’icône extraite qui correspond le mieux au périphérique d’affichage actuel. Si aucun identificateur n’est disponible pour ce format, il contient 0xFFFFFFFF. Si aucun identificateur ne peut être obtenu pour une autre raison, retourne la valeur zéro.
-
nIcons [ dans]
-
Type : uint
Nombre d’icônes à extraire de la ressource nommée dans pszFileName. Ce paramètre est valide uniquement lorsque la ressource est un fichier. exe ou. dll.
-
indicateurs [ dans]
-
Type : uint
Indicateurs qui contrôlent cette fonction. Pour connaître les valeurs possibles, consultez le paramètre fuLoad de la fonction LoadImage .
Valeur renvoyée
Type : uint
Valeur différente de zéro en cas de réussite ; Sinon, zéro.
Notes
SHExtractIconsW extrait des types de fichiers suivants.
- Fichier exécutable (.exe)
- DLL (. dll)
- Icône (. ico)
- Curseur (. cur)
- Curseur animé (. ani)
- Bitmap (.bmp)
Extractions à partir de Windows 3. x les fichiers exécutables 16 bits (. exe ou. dll) sont également pris en charge.
Les paramètres cxIcon et cyIcon spécifient la taille des icônes à extraire. Deux tailles peuvent être extraites par le biais de chaque paramètre en fractionnant la valeur entre ses LOWORD et HIWORD. Placez la première taille souhaitée dans le LOWORD du paramètre et la deuxième taille dans le HIWORD. Par exemple, MAKELONG(24, 48) pour cxIcon et cyIcon extrait les icônes 24 et 48.
Le processus appelant est responsable de la destruction de toutes les icônes extraites par le biais de cette fonction en appelant la fonction DestroyIcon .
SHExtractIconsW n’est pas exporté par nom ou déclaré dans un fichier d’en-tête public. Pour l’utiliser, vous devez déclarer un prototype correspondant et utiliser GetProcAddress pour demander un pointeur de fonction à partir de Shell32.dll qui peut être utilisé pour appeler cette fonction.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 2000 professionnel, applications de [ Bureau Windows XP uniquement] |
| Serveur minimal pris en charge |
Applications de bureau Windows Server 2003 [ uniquement] |
| DLL |
|
| Noms Unicode et ANSI |
SHExtractIconsW (Unicode) |