OPENFILENAME结构的定义

OPENFILENAMEA STRUCT

  LStructSize          DWORD     ?   ；结构的长度，用户填写

  HwndOwner            DWORD     ?   ；所属窗口，可以为NULL

  HInstance            DWORD     ?   ；

  LpstrFilter          DWORD     ?   ；文件筛选字符串

  LpstrCustomFilter    DWORD     ?

  NMaxCustFilter       DWORD     ?

  NFilterIndex         DWORD     ?

  LpstrFile            DWORD     ?   ；全路径的文件名缓冲区

  NmaxFile             DWORD     ?   ；文件名缓冲区长度

  LpstrFileTitle       DWORD     ?   ；不包含路径的文件名缓冲区

  NMaxFileTitle        DWORD     ?   ；文件名缓冲区长度

  LpstrInitialDir      DWORD     ?   ；初始目录

  LpstrTitle           DWORD     ?   ；对话框标题

  Flags                DWORD     ?   ；标志

  NFileOffset          WORD      ?   ；文件名在字符串中的起始位置

  NFileExtension       WORD      ?   ；扩展名在字符串中的起始位置

  LpstrDefExt          DWORD     ?   ；默认扩展名

  LCustData            DWORD     ?

  LpfnHook             DWORD     ?

  LpTemplateName       DWORD     ?

OPENFILENAMEA ENDS

OPENFILENAME           equ  

结构中一些重要的字段含义如下。

●   lpstrFilter――指定文件名筛选字符串，该字段决定了对话框中“文件类型”下拉式列表框 中的内容，字符串可以由多组内容组成，每组包括一个说明字符串和一个筛选字符串，字符串的最后用两个0结束。如下面的字符串将在列表框中显示两项内容，选 择不同项目的时候分别列出“*.txt”文件或者所有文件“*.*”：

'Text Files(*.txt)',0,'*.txt',0,'All Files(*.*)',0,'*.*',0,0

筛选字符串中也可以同时指定多个扩展名，中间用分号隔开，如'*.txt;*.doc'。

●   lpstrFile――指向一个包含文件名的缓冲区。如果这个缓冲区中已经包含了一个文件名，那么对话框初始化的时候将显示这个文件名。当用户选择了一个文件的时候，函数在这里返回新的文件名。

●   nMaxFile――指定lpstrFile参数指向的缓冲区的长度。

●   lpstrFileTitle――指向一个缓冲区，用来接收用户选择的不含路径的文件名。这个字段可以为NULL。

●   nMaxFileTitle――指明lpstrFileTitle参数指向的缓冲区的长度。

●   lpstrInitialDir――对话框的初始化目录，这个字段可以为NULL。

●   lpstrTitle――指向自定义的对话框标题，如果这个字段是NULL，那么“打开”对话框和“保存”对话框的默认标题是“打开”和“另存为”。

●   nFileOffset―返回文件名字符串中文件名的起始位置，如当用户选择了文件“c:\dir1\file.ext”时，这里将返回8。

●   nFileExtension――返回文件名字符串中扩展名的起始位置，同样是上面的字符串，这里返回13。如果文件名的最后一个字符是“.”，这里返回0，表示文件没有扩展名，这个字段和nFileOffset字段为分析文件名提供了方便。

●   lpstrDefExt――指定默认扩展名，如果用户输入了一个没有扩展名的文件名，那么函数会自动加上这个默认扩展名。

●   Flags字段――该标志字段决定了对话框的不同行为，它可以是一些取值的组合。下面是一些比较重要的标志：

■   OFN_ALLOWMULTISELECT――允许同时选择多个文件名。

■   OFN_CREATEPROMPT――如果用户输入了一个不存在的文件名，对话框向用户提问“是否建立文件”。

■   OFN_FILEMUSTEXIST――用户只能选择一个已经存在的文件名，使用这个标志的时候必须同时使用 OFN_PATHMUSTEXIST标志。

■   OFN_HIDEREADONLY――对话框中不显示“以只读方式打开”复选框。

■   OFN_OVERWRITEPROMPT――在“保存”文件对话框中使用的时候，当选择一个已存在的文件时，对话框会提问“是否覆盖文件”。

■   OFN_PATHMUSTEXIST――用户输入文件名时，路径必须存在。

■   OFN_READONLY――对话框中的“以只读方式打开”复选框初始化的时候处于选中状态。

调用显示“打开”或“保存”文件对话框函数时，函数会停留直到对话框关闭为止，当用户单击了对话框中的“确 定”按钮时，函数返回TRUE，用户单击“取消”按钮退出时，函数返回FALSE，程序可以由此判断是否需要继续进行打开或保存文件的操作。