Functions.GetDir 方法 | |
-- todo --
显示"选择目录"对话框,您可以从中选择目录。
命名空间:
XSharp.VFP
程序集:
XSharp.VFP (在 XSharp.VFP.dll 中) 版本:2.22 GA
语法 FUNCTION GetDir(
cDirectory,
cText,
cCaption,
nFlags,
lRootOnly
) AS STRING CLIPPER
[ClipperCallingConventionAttribute(new string[] { ... })]
public static string GetDir(
__Usual cDirectory = default,
__Usual cText = default,
__Usual cCaption = default,
__Usual nFlags = default,
__Usual lRootOnly = default
)
查看代码参数
- cDirectory (Optional)
- 类型:__Usual
指定对话框中最初显示的目录。当未指定cDirectory时,
对话框将打开并显示X#默认目录。
- cText (Optional)
- 类型:__Usual
指定对话框中目录列表的文本。
- cCaption (Optional)
- 类型:__Usual
指定要在对话框标题栏中显示的标题。Windows默认为"选择目录"。
- nFlags (Optional)
- 类型:__Usual
指定对话框的选项。nFlags可以包括零个或多个值的组合。
备注部分的表格包含一些更常用的标志。有关更多信息,请参阅MSDN中的SHBrowseForFolder。
- lRootOnly (Optional)
- 类型:__Usual
指定仅显示cDirectory及其子文件夹。此参数防止导航到根文件夹之上。
如果未指定cDirectory,则使用默认目录(Set DEFAULT值)。
返回值
类型:
String
字符型
备注
GetDir()以字符串形式返回您选择的目录名称。
如果您未选择目录(单击取消、按Esc或从窗口菜单中选择关闭),GetDir()将返回空字符串。
从X# 7开始,GetDir()支持两种不同的对话框。如果提供少于三个参数,
GetDir()将返回早期版本的对话框。如果提供超过两个参数,
X#将使用Win32 API中的
SHBrowseForFolder例程提供对话框。
nFlag | 值 | 描述 |
---|
1 | BIF_RETURNONLYFSDIRS |
仅返回文件系统目录(物理位置)。如果用户选择不属于文件系统的文件夹,"确定"按钮将变灰。
|
2 |
BIF_DONTGOBELOWDOMAIN
|
在树视图控件中不包括域级别以下的网络文件夹(例如,我的电脑和我的网络)。
|
8 |
BIF_RETURNFSANCESTORS
|
仅返回文件系统祖先。如果用户选择文件系统祖先以外的任何内容,"确定"按钮将变灰。
|
16 |
BIF_EDITBOX
|
浏览对话框包括一个编辑控件,用户可以在其中键入项目名称。在Windows 98及更高版本上可用,
或在Internet Explorer 4.0或更高版本上可用(假设选择了shell集成选项)。需要shell32.dll版本4.71。
|
32 | BIF_VALIDATE |
验证编辑框内容。如果使用编辑框,则需要验证用户指定的内容。
如果用户在编辑框中键入无效名称,取消按钮将成为唯一可用的选择。
如果未指定BIF_EDITBOX,则忽略此标志。
|
64 |
BIF_NEWDIALOGSTYLE
|
使用新的用户界面。设置此标志将为用户提供更大、可调整大小的对话框。其他功能包括:
对话框内的拖放功能、重新排序、上下文菜单、新建文件夹、删除和其他上下文菜单命令。
在Windows 2000及更高版本上支持。需要shell32.dll版本5.00。
|
16384 |
BIF_BROWSEINCLUDEFILES
|
浏览对话框将显示文件和文件夹。在Windows 98及更高版本上可用,或在Internet Explorer 4.0或更高版本上可用
(假设选择了shell集成选项)。需要shell32.dll版本4.71。
|
参见