点击或拖拽改变大小

Functions.LocFile 方法

X#
-- todo --
在磁盘上定位文件并返回带路径的文件名。

命名空间:  XSharp.VFP
程序集:  XSharp.VFP (在 XSharp.VFP.dll 中) 版本:2.22 GA
语法
 FUNCTION LocFile(
	cFileName,
	cFileExtensions,
	cFileNameCaption
) AS STRING CLIPPER
查看代码

参数

cFileName (Optional)
类型:__Usual
指定要定位的文件名。如果cFileName只包含文件名,LocFile()首先在X#默认目录或文件夹中搜索。 如果在默认目录或文件夹中未找到文件,则搜索X#路径。使用Set PATH指定X#路径。
如果cFileName包含路径和文件名,则搜索指定位置。如果在指定位置找不到文件, LocFile()会搜索X#默认目录或文件夹,然后搜索X#路径。
如果找到文件,LocFile()返回文件名和路径。
cFileExtensions (Optional)
类型:__Usual
指定要定位的文件扩展名。如果用cFileName指定的文件名不包含扩展名, X#将cFileExtensions中列出的文件扩展名应用于文件名并再次搜索文件。
当无法找到指定文件时,cFileExtensions还指定在"打开"对话框中显示的文件名扩展名。
cFileExtensions可以采用多种形式:
  • 如果cFileExtensions包含单个扩展名(例如PRG),则只显示具有该扩展名的文件。
  • cFileExtensions还可以包含通配符(*和?)。将显示所有扩展名符合通配符条件的文件。 例如,如果cFileExtensions是?X?,则会显示所有扩展名为.fxp、.exe和.txt的文件。
  • 在Windows版X#中,cFileExtensions可以包含文件描述,后跟文件扩展名或用逗号分隔的文件扩展名列表。 文件描述显示在"文件类型"列表框中。用冒号(:)分隔文件描述和文件扩展名或文件扩展名列表。 用分号(;)分隔多个文件描述及其文件扩展名。
例如,如果cFileExtensions为"Text:TXT",则"文件类型"列表框中会显示文件描述"Text", 并显示所有扩展名为.txt的文件。
如果cFileExtensions为"Tables:DBF; Files:TXT,BAK",则"文件类型"列表框中会显示文件描述"Tables"和"Files"。 从"文件类型"列表框中选择"Tables"时,将显示所有扩展名为.dbf的文件。 从"文件类型"列表框中选择"Files"时,将显示所有扩展名为.txt和.bak的文件。
cFileNameCaption (Optional)
类型:__Usual
指定用于提示用户的文本。该文本显示在输入文件名的文本框左侧。 如果省略,则显示"文件名:"。
有关X#文件扩展名和对应的创建者类型列表,请参阅"文件扩展名和文件类型"在线主题。

返回值

类型:String
字符型
备注
如果在默认目录或文件夹、X#路径或指定位置中找不到文件,则显示"打开"对话框。 可以使用"打开"对话框定位文件。从"打开"对话框中选择文件时, 返回带文件路径的文件名。
如果通过选择"取消"、按Esc键或从控制菜单中选择"关闭"来退出"打开"对话框, X#会生成错误消息,并且LocFile()不返回值。
参见