OPENFILENAME结构的定义

3782阅读 0评论2012-02-28 光速
分类:C/C++

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,程序可以由此判断是否需要继续进行打开或保存文件的操作。
上一篇:VC项目配置详解
下一篇:HRESULT返回值说明