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,程序可以由此判断是否需要继续进行打开或保存文件的操作。