locfile( ) 函数

请参阅

在磁盘上定位文件并返回带有路径的文件名。

语法

LOCFILE(cFileName [, cFileExtensions] [, cDialogCaption] [, cCreatorType])

参数
cFileName

指定要定位文件的名称。如果 cFileName 只包含文件名，locfile( ) 函数将首先搜索 Visual FoxPro 的默认目录或文件夹。如果在默认目录或文件夹中找不到该文件，则搜索 Visual FoxPro 路径。可以用 SET PATH 命令指定 Visual FoxPro 路径。
如果 cFileName 包含路径及文件名，则在指定的位置搜索。如果在指定的位置上没有找到该文件，locfile( ) 函数将先搜索 Visual FoxPro 默认目录或文件夹，然后再搜索 Visual FoxPro 路径。
如果已定位了该文件，LOCFILE( ) 返回文件名与路径。

cFileExtensions

指定要定位文件的扩展名。如果用 cFileName 指定的文件名不含扩展名，Visual FoxPro 将把 cFileExtensions 中列出的各个文件扩展名作为该文件的扩展名，并再作搜索。
cFileExtensions 还可以指定当不能定位指定的文件时，在“打开”对话框中显示的文件的扩展名。有关 Visual FoxPro 文件扩展名及相应文件创建程序类型的列表，请参阅文件扩展名和文件类型。
cFileExtensions 可以有不同的形式：

• 如果 cFileExtensions 包含单个扩展名(例如，PRG)，则只显示具有此扩展名的文件。
• cFileExtensions 可以包含文件扩展名的列表，扩展名之间用分号隔开。例如，包含 PRG;FXP 将显示扩展名为 .PRG 或 .FXP 的所有文件。
• 如果文件名称相同，而扩展名不同(例如，CUSTOMER.PRG 与 CUSTOMER.FXP)，则只显示扩展名在 cFileExtensions 中首先列出的文件。
• cFileExtensions 可以包含文件扩展名的列表，扩展名之间由垂直线分隔(例如，PRG|FXP)。在这种情况下，将显示具有其中任一扩展名的所有文件。
• 如果 cFileExtensions 只包含分号(；)，则显示不带扩展名的所有文件。
• 如果 cFileExtensions 为空字符串，并且省略 cCreatorType，则显示当前目录下的所有文件。
• cFileExtensions 还可以包含通配符(* 与 ?)，此时显示扩展名满足通配符条件的所有文件。例如，如果 cFileExtensions 为 ?X?，则所有具有扩展名为 .FXP，.EXE，或 .TXT 的文件都将显示出来。

cDialogCaption

指定用来提示用户的文本。该文本出现在“打开”对话框中。

cCreatorType

仅用于 FoxPro for Macintosh。
显示具有特定 Creator 类型的文件。如果 cFileExtensions 包含空字符串，将只显示与 cCreatorType 指定的 Creator 类型相匹配的文件。如果在 cFileExtensions 中包含了文件梗概，则将显示与文件梗概相匹配并具有 cCreatorType 指定 Creator 类型的文件。

有关 Visual FoxPro 文件扩展名及相应 Creator 类型的列表，请参阅文件扩展名和文件类型。

返回值类型

字符型

说明

如果在默认目录或文件夹下，在 Visual FoxPro 路径上以及指定位置上都无法找到该文件，将显示“打开”对话框。该对话框可用于定位文件。当从对话框中选定某个文件时，返回带有文件路径的文件名。
如果选择“取消”、按 ESC 键，或从控制菜单上选择“关闭”而退出“打开”对话框，Visual FoxPro 将产生错误信息，LOCFILE( ) 也不会返回值。