Functions.LocFile 方法 | |
-- todo --
在磁盘上定位文件并返回带路径的文件名。
命名空间:
XSharp.VFP
程序集:
XSharp.VFP (在 XSharp.VFP.dll 中) 版本:2.22 GA
语法 FUNCTION LocFile(
cFileName,
cFileExtensions,
cFileNameCaption
) AS STRING CLIPPER
[ClipperCallingConventionAttribute(new string[] { ... })]
public static string LocFile(
__Usual cFileName = default,
__Usual cFileExtensions = default,
__Usual cFileNameCaption = default
)
查看代码参数
- 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()不返回值。
参见