CFileDialog类应用详解

系统管理员 2022-08-04 05:15 190阅读 0赞

原文地址：[http://blog.csdn.net/bxwang1/article/details/3220609][http_blog.csdn.net_bxwang1_article_details_3220609]

**构造函数原型**：  
CFileDialog(BOOL bOpenFileDialog,  
            LPCTSTR lpszDefExt = NULL,  
            LPCTSTR lpszFileName = NULL,  
            DWORD dwFlags = OFN\_HIDEREADONLY | OFN\_OVERWRITEPROMPT,  
            LPCTSTR lpszFilter = NULL,  
            CWnd\* pParentWnd = NULL  
           );  
**参数：   
bOpenFileDialg**  如果为TRUE， 则创建文件打开对话框；如果为FALSE，则构造一个File Save As(另存为)对话框。   
**lpszDefExt**  缺省文件扩展名，如果用户在文件名编辑框中不包含扩展名，则lpszDefExt定义的扩展名自动加到文件名后。如果为NULL，则不添加扩展名。   
**lpszFileName**  初始显示于文件名编辑框中的文件名，如果为NULL，则不显示初始文件名。   
**dwFlags**  一个或多个标志的组合，使你可定制对话框。要了解这些标志的描述，可参阅联机文档“Win32 SDK”中的OPENFILENAME结构。如果你改变m\_ofn.Flags结构成员，在改变中用OR操作保持缺省行为完整。   
**lpszFilter**  一列字符串对，指定可以应用到文件的过滤器。如果指定过滤器，仅被选择的文件显示于文件列表框中。请参阅说明部分，了解如何使用过滤器。参数格式如：  
"Chart Files (\*.xlc)|\*.xlc|Worksheet Files (\*.xls)|\*.xls|Data Files (\*.xlc;\*.xls)|\*.xlc; \*.xls|All Files (\*.\*)|\*.\*||";文件类型说明和扩展名间用 | 分隔，同种类型文件的扩展名间可以用 ; 分割，每种文件类型间用 | 分隔，末尾用 || 指明。  
**pParentWnd**  指向文件对话框对象的父窗口或拥有者窗口。   
要使用CFileDialog，首先用构造函数构造一个对象，当创建了一个对话框后，可以设置或修改m\_ofn结构中的值来初始化对话框控件的值或状态。初始化对话框控件后，调用DoModal成员函数显示对话框并使用户输入路径和文件。  
**重要函数：**  
CString CFileDialog::GetPathName( ) 得到完整的文件名(包括目录名和扩展名)如c:/test/test1.txt   
CString CFileDialog::GetFileName( ) 得到完整的文件名(包括扩展名).如test1.txt  
CString CFileDialog::GetExtName( ) 得到完整的文件扩展名,如txt   
CString CFileDialog::GetFileTitle ( ) 得到完整的文件名,不包括目录名和扩展名,如test1   
POSITION CFileDialog::GetStartPosition( ) 对于选择了多个文件的情况得到第一个文件的位置。   
CString CFileDialog::GetNextPathName( POSITION& pos ) 对于选择了多个文件的情况得到下一个文件位置，并同时返回当前文件名。但必须已经调用过POSITION CFileDialog::GetStartPosition( )来得到最初的POSITION变量。

**打开大量文件：**

使用CFileDialog类并设置OFN\_ALLOWMULTISELECT标志时，OPENFILENAME结构体的lpstrFile成员是一个指向用户申请分配的缓冲区，里面接受所选的路径和文件名列表，这个列表的每一项由一个NULL隔开，最末以两个NULL结束。nMaxFile成员指明了缓冲区的大小，如果所选择的文件名的加起来的总长度超过了此值，则DoModal函数返回IDCANCEL，如果用户试图打开超过缓冲区大小的文件集的话，CommDlgExtendedError()将返回FNERR\_BUFFERTOOSMALL，这时候，lpstrFile的前两个byte将会包含实际需要的缓冲区的字节数。  
lpstrFile缓冲区字节数限制：     
    1 在Windows 95/98/Me下只能在ANSI下使用，且没有大小限制；  
    2 在Windows NT 4.0及更早版本下，被限制在32k字节以内；  
    3 在Windows 2000/XP版本下，MSDN中介绍说在ANSI下32k字节，Unicode下没有限制。但是，实际上两者都被限制在32k字节以内；

**示例：**  
以下是一个使用该类进行多文件名选择的例子。  
\#include "cderr.h"     
CFileDialog dlg(TRUE, NULL, NULL, OFN\_ALLOWMULTISELECT, NULL, NULL);  
CString fileName;  
DWORD MAXFILE = 32\*1024+13;  //可以适当大一些，但是不要太大，多了也是浪费！  
/\*虽然限制在32k字节以内，但是在运行时少于此值将会返回IDCANCEL及FNERR\_BUFFERTOOSMALL错误。运行时我选择了800个文件只能读取564个文件路径和文件名列表，共计32781个字节\*/  
dlg.m\_ofn.lpstrFile = fileName.GetBuffer(MAXFILE);  
dlg.m\_ofn.nMaxFile = MAXFILE;  
fileName.ReleaseBuffer();  
int iReturn = dlg.DoModal();  
if(iReturn == IDOK)  
\{  
int nCount = 0;  
POSITION pos = dlg.GetStartPosition();  
while (pos != NULL)  
\{  
dlg.GetNextPathName(pos);  
nCount++;  
\}  
CString str;  
str.Format(\_T("Successfully opened %d files "), nCount);  
AfxMessageBox(str);  
\}  
else if(iReturn == IDCANCEL)  
     AfxMessageBox(\_T("Cancel"));  
if(CommDlgExtendedError() == FNERR\_BUFFERTOOSMALL)  
     AfxMessageBox(\_T("BUFFERTOOSMALL"));

CFileDialog

<table style="color:rgb(51,51,51); font-size:14px; line-height:26px; font-family:宋体"> 
 <tbody> 
  <tr> 
   <td style="font-family:宋体"><span style="background-color:silver"><a href="http://www.kaifa6.com/v/mfcshouce/class/CObject.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">CObject</a></span></td> 
  </tr> 
  <tr> 
   <td style="font-family:宋体">&nbsp;└<span style="background-color:silver"><a href="http://www.kaifa6.com/v/mfcshouce/class/CCmdTarget.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">CCmdTarget</a></span></td> 
  </tr> 
  <tr> 
   <td style="font-family:宋体">&nbsp;&nbsp;&nbsp;&nbsp;└<span style="background-color:silver"><a href="http://www.kaifa6.com/v/mfcshouce/class/CWnd.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">CWnd</a></span></td> 
  </tr> 
  <tr> 
   <td style="font-family:宋体">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;└<span style="background-color:silver"><a href="http://www.kaifa6.com/v/mfcshouce/class/CDialog.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">CDialog</a></span></td> 
  </tr> 
  <tr> 
   <td style="font-family:宋体">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;└<span style="background-color:silver"><a href="http://www.kaifa6.com/v/mfcshouce/class/CCommonDialog.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">CCommonDialog</a></span></td> 
  </tr> 
  <tr> 
   <td style="font-family:宋体">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;└<span style="background-color:silver">CFileDialog</span></td> 
  </tr> 
 </tbody> 
</table>

CFileDialog类封装了Windows常用的文件对话框。常用的文件对话框提供了一种简单的与Windows标准相一致的文件打开和文件存盘对话框功能。  
可以用构造函数提供的方式使用CFileDialog，也可以从CFileDialog派生出自己的对话类并编写一个构造函数来适应你的需要。每种情况下，对话框都与标准MFC对话框一样工作。因为它们都是CCommonDialog类的派生类。  
要使用CFileDialog，先用CFileDialog构造函数构造一个对象，当创建了一个对话框后，可以设置或修改m\_ofn结构中的任何值，以初始化对话框控件的值或状态。m\_ofn结构是OPENFILENAME类型的。要了解更多信息，可参阅联机文档“Win32 SDK”中的OPENFILENAME结构。  
初始化对话框控件后，调用DoModal成员函数显示对话框并使用户输入路径和文件。DoModal返回不论是用户选择了OK（IDOK）还是取消（IDCANCEL）按钮。  
当DoModal返回IDOK，可以使用某一个CFileDIalog的公共成员函数获取用户输入的信息。  
CFileDIalog包含许多保护成员，使你可以处理常用的共享冲突、文件名合法性检查、列表框改变通知。这些保护成员对许多应用来说用处不大，因为缺省处理是自动的。对这些函数来说，消息映射入口是不必要的，因为它们是标准虚函数。  
可以使用Windows CommDlgExtendError函数判断在初始化对话框时是否是发生了错误，并获取关于错误的更多信息。  
析构一个CFileDialog对象是自动，无须调用CDialog::EndDialog。  
要使用户选用多个文件，可在调用DoModal之前设置OFN\_ALLOWMULTISELECT标志。你应提供文件名缓冲区来放置返回的多个文件名的列表，这通过用一个分配了的缓冲区指针替换m\_ofn.lpstrFile来实现，要在创建了CFileDialog之后调用DoModal之前进行此操作。另外，必须用m\_ofn.lpstrFile指向的缓冲区字节数来设置m\_ofn.nMaxFile。  
CFileDialog依赖于Windows3.1及以后版本中的COMMDLG.DLL。  
如果从CFileDialog中派生出一个新类，可用消息映射处理。要扩展消息处理，从CWnd中派生一个类，向新类中加入一个消息映射并为新消息提供成员函数，无须提供一个钩子函数来定制对话框。  
要定制对话框，从CFileDialog中派生一个对象，提供一个定制对话模板，从扩展控件中加入一个消息映射，处理通知消息。任意未处理的消息将传递给基类。  
无须定制钩子函数。  
要了解有关使用CFileDialog的信息，可参阅联机文档“Visual C++程序员指南”中的“常用对话类”。  
\#include <afxdlgs.h>  
  
CFileDialog类的成员  
  
数据成员

构造函数

<table style="color:rgb(51,51,51); font-size:14px; line-height:26px; font-family:宋体"> 
 <tbody> 
  <tr> 
   <td style="font-family:宋体"><a href="http://www.kaifa6.com/v/mfcshouce/class/CFileDialog_CFileDialog.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">CFileDialog</a></td> 
   <td style="font-family:宋体">构造一个CFileDialog对象操作</td> 
  </tr> 
  <tr> 
   <td style="font-family:宋体"><a href="http://www.kaifa6.com/v/mfcshouce/class/CFileDialog_DoModal.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">DoModal</a></td> 
   <td style="font-family:宋体">显示对话框并使用户可以进行选择</td> 
  </tr> 
  <tr> 
   <td style="font-family:宋体"><a href="http://www.kaifa6.com/v/mfcshouce/class/CFileDialog_GetPathName.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">GetPathName</a></td> 
   <td style="font-family:宋体">返回选定文件的完整路径</td> 
  </tr> 
  <tr> 
   <td style="font-family:宋体"><a href="http://www.kaifa6.com/v/mfcshouce/class/CFileDialog_GetFileName.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">GetFileName</a></td> 
   <td style="font-family:宋体">返回选定文件的文件名</td> 
  </tr> 
  <tr> 
   <td style="font-family:宋体"><a href="http://www.kaifa6.com/v/mfcshouce/class/CFileDialog_GetFileExt.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">GetFileExt</a></td> 
   <td style="font-family:宋体">返回选定文件的扩展文件名</td> 
  </tr> 
  <tr> 
   <td style="font-family:宋体"><a href="http://www.kaifa6.com/v/mfcshouce/class/CFileDialog_GetFileTitle.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">GetFileTitle</a></td> 
   <td style="font-family:宋体">返回选定文件的标题</td> 
  </tr> 
  <tr> 
   <td style="font-family:宋体"><a href="http://www.kaifa6.com/v/mfcshouce/class/CFileDialog_GetNextPathName.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">GetNextPathName</a></td> 
   <td style="font-family:宋体">返回下一个选定文件的完整路径</td> 
  </tr> 
  <tr> 
   <td style="font-family:宋体"><a href="http://www.kaifa6.com/v/mfcshouce/class/CFileDialog_GetReadOnlyPref.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">GetReadOnlyPref</a></td> 
   <td style="font-family:宋体">返回选定文件的只读状态</td> 
  </tr> 
  <tr> 
   <td style="font-family:宋体"><a href="http://www.kaifa6.com/v/mfcshouce/class/CFileDialog_GetStartPosition.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">GetStartPosition</a></td> 
   <td style="font-family:宋体">返回文件名列表的第一个元素位置</td> 
  </tr> 
 </tbody> 
</table>

可覆盖的函数

<table style="color:rgb(51,51,51); font-size:14px; line-height:26px; font-family:宋体"> 
 <tbody> 
  <tr> 
   <td style="font-family:宋体"><a href="http://www.kaifa6.com/v/mfcshouce/class/CFileDialog_OnShareViolation.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">OnShareViolation</a></td> 
   <td style="font-family:宋体">发生共享冲突时调用</td> 
  </tr> 
  <tr> 
   <td style="font-family:宋体"><a href="http://www.kaifa6.com/v/mfcshouce/class/CFileDialog_OnFileNameOK.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">OnFileNameOK</a></td> 
   <td style="font-family:宋体">确认键入对话框中的文件名</td> 
  </tr> 
  <tr> 
   <td style="font-family:宋体"><a href="http://www.kaifa6.com/v/mfcshouce/class/CFileDialog_OnLBSelChangedNotify.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">OnLBSelChangedNotify</a></td> 
   <td style="font-family:宋体">当列表框选择改变时调用</td> 
  </tr> 
  <tr> 
   <td style="font-family:宋体"><a href="http://www.kaifa6.com/v/mfcshouce/class/CFileDialog_OnInitDone.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">OnInitDone</a></td> 
   <td style="font-family:宋体">处理WM_NOTIFY CDN_INITDONE消息</td> 
  </tr> 
  <tr> 
   <td style="font-family:宋体"><a href="http://www.kaifa6.com/v/mfcshouce/class/CFileDialog_OnFileNameChange.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">OnFileNameChange</a></td> 
   <td style="font-family:宋体">处理WM_NOTIFY CDN_SELCHANGE消息</td> 
  </tr> 
  <tr> 
   <td style="font-family:宋体"><a href="http://www.kaifa6.com/v/mfcshouce/class/CFileDialog_OnFolderChange.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">OnFolderChange</a></td> 
   <td style="font-family:宋体">处理WM_NOTIFY CDN_FOLDERCHANGE消息</td> 
  </tr> 
  <tr> 
   <td style="font-family:宋体"><a href="http://www.kaifa6.com/v/mfcshouce/class/CFileDialog_OnTypeChange.htm" style="color:rgb(0,0,255); text-decoration:none" rel="nofollow">OnTypeChange</a></td> 
   <td style="font-family:宋体">处理WM_NOTIFY CDN_TYPECHANGE消息<br> </td> 
  </tr> 
 </tbody> 
</table>

[http_blog.csdn.net_bxwang1_article_details_3220609]: http://blog.csdn.net/bxwang1/article/details/3220609