putfile( ) 函数

示例 请参阅

激活“另存为 …”对话框，并返回指定的文件名。

语法

PUTFILE([cDialogCaption] [, cFileName] [, cFileExtensions])

返回值类型

字符型

参数
cDialogCaption

指定在“另存为 …”对话框上部显示的标题。注意：在 Windows 95 中，长标题可能被截断。

cFileName

指定在文本框中显示的默认文件名。

cFileExtensions

指定文件的扩展名。当清除“所有文件”复选框时，在“另存为 …”对话框的可滚动列表中，只显示具有指定扩展名的文件名。如果输入的文件名不包含扩展名，cFileExtensions 中的第一个扩展名会自动加到文件名上。有关 Visual FoxPro 中文件扩展名列表和相应的生成器类型，请参阅文件扩展名和文件类型主题。
Macintosh 忽略 cFileExtensions。可滚动列表中显示所有文件，但不能选中它们。可以选择可滚动列表中的文件夹，以便指定文件所在的文件夹。
字符表达式 cFileExtensions 可以是下列某一形式：

• cFileExtensions 可以包含单个的扩展名(例如 PRG)，只有带这个扩展名的文件名才被显示。
  
• cFileExtensions 可以包含用分号分隔的文件扩展名列表。例如，如果包含 PRG;FXP，Visual FoxPro 将显示所有带 PRG 和 FXP 扩展名的文件名。
  
• 如果文件名具有相同的基本名，但扩展名不同(例如，CUSTOMER.PRG 和 CUSTOMER.FXP)，Visual FoxPro 所显示的文件是其扩展名在 cFileExtension 中位置靠前的文件。
  
• cFileExtensions 可包含用竖线分隔的文件扩展名列表，例如 PRG|FXP。在这种情况下，即使文件有相同的基本名，Visual FoxPro 也把所有具有指定扩展名的文件名显示出来。
  
• 如果 cFileExtensions 只包含一个分号 (；)，Visual FoxPro 显示所有不带扩展名的文件名。
  
• 如果 cFileExtensions 是个空字符串，Visual FoxPro 显示当前目录中的所有文件名。
  
• 如果 cFileExtensions 包含 MS-DOS 通配符，例如问号 (?) 和星号 (*)，Visual FoxPro 显示所有扩展名符合通配符条件的文件名。例如，如果 cFileExtensions 包含 ?X?，扩展名为 .FXP，.EXE，.TXT 等等的文件都会显示。

说明

可以使用 PUTFILE( ) 选择现有的文件名或指定新文件名，PUTFILE( ) 返回一个文件名及其路径。如果不输入文件名，PUTFILE( ) 返回默认的文件名 (由 cFileName 指定) 和扩展名 (由 cFileExtensions 指定)；如果选定“取消”或按 ESC 键，PUTFILE( ) 返回一个空字符串。可以使用 PUTFILE( ) 返回的文件名命名一个文件并把它保存到磁盘上。