GetFileNameFromBrowse, fonction (shlobj.h)
[Cette fonction est disponible via Windows XP Service Pack 2 (SP2) et Windows Server 2003. Il peut être modifié ou indisponible dans les versions ultérieures de Windows.]
Crée une boîte de dialogue Ouvrir afin que l’utilisateur puisse spécifier le lecteur, le répertoire et le nom d’un fichier à ouvrir.
Syntaxe
BOOL GetFileNameFromBrowse(
[in, optional] HWND hwnd,
[in, out] PWSTR pszFilePath,
UINT cchFilePath,
[in, optional] PCWSTR pszWorkingDir,
[in] PCWSTR pszDefExt,
[in, optional] PCWSTR pszFilters,
[in, optional] PCWSTR pszTitle
);
Paramètres
[in, optional] hwnd
Type : HWND
Handle de la fenêtre qui possède la boîte de dialogue. Ce membre peut être n’importe quel handle de fenêtre valide, ou il peut avoir la valeur NULL si la boîte de dialogue n’a pas de propriétaire.
[in, out] pszFilePath
Type : PWSTR
Chaîne Unicode terminée par null qui contient un nom de fichier utilisé pour initialiser le contrôle d’édition du nom de fichier. Cette chaîne correspond au membre lpstrFile de la structure OPENFILENAME et est utilisée exactement de la même manière.
cchFilePath
Type : UINT
Nombre de caractères dans pszFilePath, y compris le caractère null de fin.
[in, optional] pszWorkingDir
Type : PCWSTR
Chemin d’accès au fichier complet du répertoire initial. Cette chaîne correspond au membre lpstrInitialDir de la structure OPENFILENAME et est utilisée exactement de la même manière.
[in] pszDefExt
Type : PCWSTR
Chaîne Unicode terminée par null qui contient l’extension de nom de fichier par défaut. Cette extension est ajoutée à pszFilePath si l’utilisateur ne spécifie pas d’extension. La chaîne ne doit pas contenir de caractères « . ». Si cette chaîne a la valeur NULL et que l’utilisateur ne parvient pas à taper une extension, aucune extension n’est ajoutée.
[in, optional] pszFilters
Type : PCWSTR
Chaîne Unicode terminée par null qui définit le filtre. Cette chaîne correspond au membre lpstrFilter de la structure OPENFILENAME et est utilisée exactement de la même manière.
[in, optional] pszTitle
Type : PCWSTR
Chaîne Unicode terminée par null qui est placée dans la barre de titre de la boîte de dialogue. Si cette valeur est NULL, le système utilise le titre par défaut.
Valeur retournée
Type : BOOL
Si l’utilisateur spécifie un nom de fichier et clique sur OK, la valeur de retour est TRUE. La mémoire tampon vers laquelle pszFilePath pointe contient le chemin d’accès complet et le nom de fichier spécifiés par l’utilisateur. Si l’utilisateur annule ou ferme la boîte de dialogue Ouvrir ou si une erreur se produit, la valeur renvoyée est FALSE.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shlobj.h (inclure Shlobj.h) |
| Bibliothèque | Shell32.lib |
| DLL | Shell32.dll (version 5.0 ou ultérieure) |