DlgDirSelectComboBoxExA, fonction (winuser.h)
Récupère la sélection actuelle à partir d’une zone de liste modifiable 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
Type : HWND
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 sélectionné.
[in] cchOut
Type : int
Longueur, en caractères, de la mémoire tampon vers laquelle pointe le paramètre lpString .
[in] idComboBox
Type : int
Identificateur entier du contrôle de zone de liste déroulante dans la boîte de dialogue.
Valeur retournée
Type : BOOL
Si la sélection actuelle est un nom de répertoire, la valeur de retour est différente de zéro.
Si la sélection actuelle n’est pas un nom de répertoire, la valeur de retour est zéro. Pour obtenir des informations détaillées sur l’erreur, 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 nom de fichier. En l’absence de sélection, le contenu de la mémoire tampon pointée par lpString ne change pas.
La fonction DlgDirSelectComboBoxEx n’autorise pas le retour de plusieurs noms 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 déroulante (CBS_SIMPLE, CBS_DROPDOWN et CBS_DROPDOWNLIST).
Avertissement de sécurité : Une utilisation incorrecte de cette fonction peut entraîner des problèmes pour votre application. Pour instance, le paramètre nCount doit être défini correctement pour les versions ANSI et Unicode. Si vous ne le faites pas, vous risquez d’entraîner un dépassement de capacité de la mémoire tampon. Vous devez consulter Considérations relatives à la sécurité : Contrôles Microsoft Windows avant de continuer.
Windows 95 ou version ultérieure : DlgDirSelectComboBoxExW est pris en charge par Microsoft Layer pour Unicode (MSLU). Pour l’utiliser, vous devez ajouter certains fichiers à votre application, comme indiqué dans Microsoft Layer pour Unicode sur les systèmes Windows Me/98/95.
Notes
L’en-tête winuser.h définit DlgDirSelectComboBoxEx en tant qu’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. La combinaison 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winuser.h (inclure Windows.h) |
| Bibliothèque | User32.lib |
| DLL | User32.dll |
Voir aussi
Référence