CFileDialog ( BOOL bOpenFileDialog, LPCTSTR lpszDefExt = NULL, LPCTSTR lpszFileName = NULL, DWORD dwFlags = OFN_HIDEREADONLY | OFN_OVERWRITEPROMPT, LPCTSTR lpszFilter = NULL, CWnd * pParentWnd = NULL );
Paramètres
bOpenFileDialog
Valeur TRUE pour construire une boîte de dialogue fichier ouvrir ou faux pour construire une boîte de dialogue fichier enregistrer sous.
lpszDefExt
L'extension de nom de fichier par défaut. Si l'utilisateur n'inclut pas une extension dans la boîte nom de fichier, l'extension spécifiée par lpszDefExt est ajoutée automatiquement le nom de fichier. Si ce paramètre est NULL, aucune extension de fichier n'est joint en annexe.
lpszFileName
Zone de texte le nom du fichier initial qui apparaît dans le nom du fichier. Si NULL, aucun nom de fichier apparaît d'abord.
dwFlags
Une combinaison d'un ou plusieurs indicateurs qui vous permettent de personnaliser la boîte de dialogue. Pour une description de ces indicateurs, consultez la structure OPENFILENAME dans la documentation du SDK Win32. Si vous modifiez la m_ofn .Drapeaux membre la structure, utilisez un opérateur de bits OR vos modifications pour préserver le comportement par défaut.
lpszFilter
Une série de paires de chaînes qui spécifient des filtres, vous pouvez appliquer au fichier. Si vous spécifiez des filtres de fichier, seuls les fichiers sélectionnés apparaîtront dans la zone de liste de fichiers. Consultez la section Remarques pour plus d'informations sur la façon de travailler avec des filtres de fichier.
pParentWnd
Un pointeur vers la fenêtre parente ou le propriétaire de l'objet de boîte de dialogue fichier.
Remarques
Appelez cette fonction pour construire un standard Windows fichier objet boîte de dialogue. La boîte de dialogue Ouvrir ou enregistrer sous fichier est construite, selon la valeur de bOpenFileDialog.
Pour permettre à l'utilisateur de sélectionner plusieurs fichiers, définissez l'indicateur OFN_ALLOWMULTISELECT avant d'appeler DoModal. Vous devez fournir votre propre tampon filename pour accommoder la liste retournée de noms de fichiers multiples. Cela en remplaçant m_ofn.lpstrFile par un pointeur vers une mémoire tampon que vous avez attribué, après la construction du CFileDialog, mais avant d'appeler DoModal. En outre, vous devez définir m_ofn.nMaxFile avec le nombre de caractères dans la mémoire tampon pointée par m_ofn.lpstrFile.
Pour permettre à l'utilisateur de redimensionner une boîte de dialogue de style Explorateur à l'aide de la souris ou le clavier, définissez l'indicateur OFN_ENABLESIZING . La définition de cet indicateur n'est nécessaire que si vous fournissez une procédure de hook ou un modèle personnalisé. Le drapeau ne fonctionne qu'avec une boîte de dialogue style Explorateur ; boîtes de dialogue de style ancien ne permettent pas de redimensionnement.
Le paramètre lpszFilter est utilisé pour déterminer le type de fichier, qu'un fichier doit avoir pour être affichée dans la zone de liste de fichier. La première chaîne dans la paire de chaîne décrit le filtre ; la deuxième chaîne indique l'extension de fichier à utiliser. Plusieurs extensions peuvent être spécifiées à l'aide de «; » comme délimiteur. La chaîne se termine par deux ' |' caractères, suivi par un caractère NULL . Vous pouvez également utiliser un objet CString pour ce paramètre.
Par exemple, Microsoft Excel permet aux utilisateurs d'ouvrir des fichiers avec les extensions.XLC (graphique) ou.XLS (feuille de calcul), parmi d'autres. Le filtre Excel peut être écrite comme:
char statique BASED_CODE-r [] = "fichiers graphique (*.xlc) | *. xlc|Les fichiers de feuille de calcul (*.xls) | *. xls|Les fichiers de données (*.xlc ; *.xls) | * .xlc ; *. xls|Tous les fichiers (*. *) | *. * || »
Aperçu de CFileDialog | ; Membres de la classe | Graphique de la hiérarchie
Voir aussinbsp ;CFileDialog::DoModal, :: GetOpenFileName, :: GetSaveFileName, OPENFILENAME