DlgDirSelectComboBoxExA, fonction (winuser.h)
Récupère la sélection actuelle à partir d’une zone de liste déroulante remplie à l’aide de la fonction DlgDirListComboBox. La sélection est interprétée comme une lettre de lecteur, un fichier ou un nom de répertoire.
Syntaxe
BOOL DlgDirSelectComboBoxExA(
[in] HWND hwndDlg,
[out] LPSTR lpString,
[in] int cchOut,
[in] int idComboBox
);
Paramètres
[in] hwndDlg
Handle de la boîte de dialogue qui contient la zone de liste déroulante.
[out] lpString
Type : LPTSTR
Pointeur vers la mémoire tampon qui reçoit le chemin d’accès sélectionné.
[in] cchOut
Type : int
Longueur, en caractères, de la mémoire tampon pointée par le paramètre lpString.
[in] idComboBox
Type : int
Identificateur entier du contrôle de zone de liste modifiable dans la boîte de dialogue.
Valeur de retour
Type : BOOL
Si la sélection actuelle est un nom de répertoire, la valeur de retour n’est pas nulle.
Si la sélection actuelle n’est pas un nom de répertoire, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Remarques
Si la sélection actuelle spécifie un nom de répertoire ou une lettre de lecteur, la fonction DlgDirSelectComboBoxEx supprime les crochets englobants (et les traits d’union pour les lettres de lecteur) afin que le nom ou la lettre soit prêt à être inséré dans un nouveau chemin d’accès ou un nom de fichier. S’il n’existe aucune sélection, le contenu de la mémoire tampon pointée par lpString ne change pas.
La fonction DlgDirSelectComboBoxEx n’autorise pas le retour d’un nom de fichier à partir d’une zone de liste déroulante.
Si la chaîne est aussi longue ou plus longue que la mémoire tampon, la mémoire tampon contient la chaîne tronquée avec un caractère null de fin.
DlgDirSelectComboBoxEx envoie des messages CB_GETCURSEL et CB_GETLBTEXT à la zone de liste déroulante.
Vous pouvez utiliser cette fonction avec les trois types de zones de liste modifiable (CBS_SIMPLE, CBS_DROPDOWNet CBS_DROPDOWNLIST).
Avertissement de sécurité : utilisation incorrecte de cette fonction peut entraîner des problèmes pour votre application. Par exemple, le paramètre nCount doit être défini correctement pour les versions ANSI et Unicode. L’échec de cette opération peut entraîner un dépassement de mémoire tampon. Vous devez passer en revue considérations relatives à la sécurité : contrôles Microsoft Windows avant de continuer.
Windows 95 ou version ultérieure: DlgDirSelectComboBoxExW est prise en charge par microsoft Layer for Unicode (MSLU). Pour l’utiliser, vous devez ajouter certains fichiers à votre application, comme indiqué dans Microsoft Layer pour Unicode sur Windows Me/98/95 Systems.
Note
L’en-tête winuser.h définit DlgDirSelectComboBoxEx comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winuser.h (include Windows.h) |
| bibliothèque | User32.lib |
| DLL | User32.dll |
Voir aussi
de référence