Partager via

PickIconDlg, fonction (shlobj_core.h)

  • Article

[PickIconDlg est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

Affiche une boîte de dialogue qui permet à l’utilisateur de choisir une icône parmi la sélection disponible incorporée dans une ressource telle qu’un fichier exécutable ou DLL.

Syntaxe

int PickIconDlg(
  [in, optional]      HWND  hwnd,
  [in, out]           PWSTR pszIconPath,
                      UINT  cchIconPath,
  [in, out, optional] int   *piIconIndex
);

Paramètres

[in, optional] hwnd

Type : HWND

Handle de la fenêtre parente. Cette valeur peut être NULL.

[in, out] pszIconPath

Type : PWSTR

Pointeur vers une chaîne qui contient le chemin complet de la ressource par défaut qui contient les icônes. Si l’utilisateur choisit une autre ressource dans la boîte de dialogue, cette mémoire tampon contient le chemin de ce fichier lorsque la fonction retourne. Cette mémoire tampon doit comporter au moins MAX_PATH caractères, sinon le chemin d’accès retourné peut être tronqué. Vous devez vérifier que le chemin d’accès est valide avant de l’utiliser.

cchIconPath

Type : UINT

Nombre de caractères dans pszIconPath, y compris le caractère NULL de fin.

[in, out, optional] piIconIndex

Type : int*

Pointeur vers un entier qui, lors de l’entrée, spécifie l’index de la sélection initiale et, lorsque cette fonction retourne correctement, reçoit l’index de l’icône sélectionnée.

Valeur retournée

Type : int

Retourne 1 en cas de réussite ; sinon, 0.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shlobj_core.h (inclure Shlobj.h)
Bibliothèque Shell32.lib
DLL Shell32.dll (version 6.0 ou ultérieure)
Ensemble d’API ext-ms-win-shell-shell32-l1-2-1 (introduit dans Windows 10, version 10.0.10240)