WinX教程之我的实战（八）

现代操作系统都有文件系统的概念，所以有时候程序需要用户自己指定文件。在命令行下用户可以将自己指定的文件以参数形式传递，在图形界面下用户可以采用交互选择方式。在Windows下，我们把它叫做打开文件对话框（Open File Dialog），是通用对话框的一种（通用对话框还包括了颜色选择对话框、页面设置对话框、打印对话框等等）。今天我们来实战WinX里对打开文件对话框和保存文件对话框的封装，我们暂且把他们二者统称为文件对话框。WinX共提供了两种文件对话框，包括单文件对话框和多文件对话框，让我们看看WinX的操作和API方式、MFC方式有什么不同。

我们实战的例子程序就是step008-openfiles，该例程包含两个工程：

• API方式

API实现打开文件对话框主要通过一个结构（OPENFILENAME）和一个API（GetOpenFileName）实现，此外还有一些辅助函数。OPENFILENAME定义如下（为了方便说明有所修改）：

 

typedef  struct  tagOFN  ... { 

DWORD lStructSize; //结构大小字节数 

HWND hwndOwner; //对话框的所有者窗口句柄，也就是父窗口 

HINSTANCE hInstance; .//包含对话框的应用程序句柄 

LPCTSTR lpstrFilter; //过滤器字符串 

LPTSTR lpstrCustomFilter; //自定义过滤器 

DWORD nMaxCustFilter; //自定义过滤器字符串长度最大值 

DWORD nFilterIndex; //默认过滤器模式索引 

LPTSTR lpstrFile; //全路径文件名 

DWORD nMaxFile; //文件名长度最大值 

LPTSTR lpstrFileTitle; //文件名 

DWORD nMaxFileTitle; //文件名长度最大值 

LPCTSTR lpstrInitialDir; //初始目录 

LPCTSTR lpstrTitle; //对话框标题字符串 

DWORD Flags; //标志，这里指定对话框的行为状态 

WORD nFileOffset; //文件名在全路径中的偏移 

WORD nFileExtension; //扩展名偏移 

LPCTSTR lpstrDefExt; //默认扩展名 

LPARAM lCustData; //传递给hook函数的自定义数据 

LPOFNHOOKPROC lpfnHook; //hook函数 

LPCTSTR lpTemplateName; //对话框模板名 

}  OPENFILENAME,  * LPOPENFILENAME; 

 

详细介绍请参阅MSDN。

API方式下，如果要显示打开文件对话框，就需要调用API函数GetOpenFileName，他的参数就是上面这个结构的指针；如果需要显示保存文件对话框，就需要调用API函数GetSaveFileName。二者原型如下：

 

 

BOOL GetOpenFileName( LPOPENFILENAME lpofn); 

BOOL GetSaveFileName( LPOPENFILENAME lpofn); 

用户关心的返回值也都通过参数传回，毕竟用户需要的还是通过显示对话框得到一个全路径和文件名。

不过OPENFILENAME结构的一堆成员都需要用户指定，对于只是一个简单的打开或保存文件对话框来说，也确实麻烦了一些。

• MFC方式

MFC对于打开和保存文件对话框进行了封装，都包括在CFileDialog里面。MFC方式显示文件对话框，必须先构建CFileDialog对象，然后调用DoModal方法来显示对话框窗口。我们看看CFileDialog构造函数和DoModal函数原型：

 

CFileDialog( BOOL bOpenFileDialog, LPCTSTR lpszDefExt  =  NULL, LPCTSTR lpszFileName  =  NULL, DWORD dwFlags  =  OFN_HIDEREADONLY  |  OFN_OVERWRITEPROMPT, LPCTSTR lpszFilter  =  NULL, CWnd *  pParentWnd  =  NULL ); 

virtual   int  DoModal( ); 

 

可见MFC将指定给OPENFILENAME结构的参数都放在了CFileDialog的构造函数中，DoModal没有参数。

通过查看MFC源代码，发现OPENFILENAME是作为CFileDialog的公共成员变量实现的。MFC还提供了虚拟函数，通过重载虚拟函数可以改变CFileDialg的行为。

MFC的封装貌似简化了操作，如将打开文件对话框和保存文件对话框封装在一个类里面，似乎达到了界面一致。但MFC方式最大的缺点是并没有把用户和底层完全隔离开来，用户还需要了解OPENFILENAME结构的成员的含义和用法。一般来说，对于文件对话框，包括多文件对话框，无非是用户希望这种GUI交互方式获取用户的输入，获得用户选择的或者要保存的文件名和路径等。一些不常用的不应该成为用户掌握基本用法的障碍。

• WINX方式

WinX的文件对话框定义在CommonDialogs.h文件中。WinX是将单文件对话框和多文件对话框分别定义的。我们先来看看其对单文件的定义：

 

enum  FileDialogType 

... { 

fdtSaveFileDialog = 0, 

fdtOpenFileDialog = 1, 

} ; 

template  < INT nFileDlgType >  

class  FileDialogT :  public  OPENFILENAME 

... { 

// ... 

} ; 

typedef FileDialogT < fdtOpenFileDialog >  FileDialog; 

typedef FileDialogT < fdtOpenFileDialog >  OpenFileDialog; 

typedef FileDialogT < fdtSaveFileDialog >  SaveFileDialog; 

枚举界定了文件对话框类型（打开或保存），最终表现为不同的类，OpenFileDialog和SaveFileDialog。最有意思的是（个人感觉），WinX不像MFC那样将OPENFILENAME结构作为成员变量封装，而且只是派生自这个系统结构。其实二者对象在二进制结构上没有区别，但是类里面的具体写法WinX方式就简单了，不像MFC那样还要ofn.xxx的方式来引用，WinX直接引用OPENFILENAME成员名就可以了。

当然，上面这个对最终用户基本没什么作用。用户关心的是使用是不是简单。假设你需要一个单文件打开文件对话框，就像本实战分析的教程实例中一样，只需要以下代码就可以：

 

winx::OpenFileDialog dlg(_T( " Text Files(*.txt)/0*.txt/0All Files(*.*)/0*.*/0 " ));

if  (IDOK  !=  dlg.DoModal()) 
      return   - 1 ; 

 

在winx::OpenFileDialog类的构造函数中指定文件过滤器（我想一般个人都有不同的过滤器），其他参数都按照常用的默认值，最后DoModal就可以了。

我们看看winx::OpenFileDialog类构造函数和DoModal函数的原型：

 

FileDialogT( 

IN LPCTSTR szFilter  =  NULL, 

IN LPCTSTR szDefExt  =  NULL, 

IN LPCTSTR szDlgTitle  =  NULL, 

IN LPCTSTR szInitFileName  =  NULL, 

IN UINT nInitFilterIndex  =   1 , 

IN LPCTSTR szInitialDir  =  NULL)； 

int  winx_call DoModal( 

HWND hWndParent  =  NULL, INT dlgType  =  nFileDlgType, HINSTANCE hInst  = GetThisModule())； 

 

初看起来和MFC相比，只是有些参数顺序和所在函数有变化而已，深层次上来讲，WinX将抽象和具体化分的更清了。构造函数里的参数都是抽象层次上的，他们都不依赖于文件对话框的类型（打开或保存）、父窗口、资源句柄，而这些具体层次上的参数都移到了DoModal里面，在对话框显示出来的前一刻指定。也就是说，你可以构造一个OpenFileDialog对象，然后将它以不同的形式显示出来，如改变父窗口，改变类型，改变资源句柄。

最后又将单一FileDialog模板定义进行分解成了三个类，这样设计的指导思想又是什么？我认为是这样，如果用户一开始对自己要使用什么对话框是清楚的（到底是打开文件对话框还是保存文件对话框），就可以直接选择自己需要的类，其他参数就可以全部采用默认的，使用简单。用户用的中间过程想改变一下对话框行为，还有机会进行修改，使用灵活。这个小问题，WinX为用户还是想得很多。

除此外还有对多文件对话框的封装，基本思想一致，有兴趣的朋友可以看看commondialogs.h的源码。

另人遗憾的是，WinX只对通用对话框中的文件对话框进行了封装。