演示应用程序
演示应用程序中设置生成的对话框

引言
ShellFolderBrowser
是一个组件,它使在 .NET 应用程序中使用 Shell 的文件夹浏览对话框成为可能。它可以像框架 SDK 提供的 OpenFileDialog
和 SaveFileDialog
组件一样使用。 该组件使用 SHBrowseForFolder
函数,并演示了托管和非托管代码互操作的各个方面,例如传递委托函数指针、传递结构和字符串。
使用该组件非常简单。您可以将其放置在工具箱中,并将其拖动到窗体上。您可以在属性网格中设置组件中所需的属性,如下所示:-
为了显示对话框,需要做的就是调用 ShowDialog
方法,如下所示:
folderBrowser1.ShowDialog();
以下是对该组件的简要描述。有关详细说明,请参见 SHBrowseForFolder
的文档。
属性
BrowseFlags |
设置控制对话框行为的标志 |
FolderDisplayName |
用户选择的文件夹的显示名称 |
FolderPath |
所选文件夹的路径 |
标题 |
显示在对话框中的树视图控件上方的字符串。该字符串可用于指定给用户的说明。只能在当前未显示对话框时修改。 |
方法
EnableOKButton |
启用或禁用对话框中的“确定”按钮 |
SetExpanded |
在文件夹中展开一个路径 |
SetOkButtonText |
设置对话框中“确定”按钮的文本 |
SetSelection |
设置指定的文本的选择 |
SetStatusText |
设置文件夹对话框的状态区域的文本 |
ShowDialog |
显示对话框 |
事件
Initialized |
在对话框初始化时触发(当 BFFM_INITIALIZED 发送到 BrowseCallback 函数时) |
IUnknownObtained |
Shell 通过此事件提供一个 IUnknown 。有关详细信息,请参见 SHBrowseForFolder 的文档(当 BFFM_INITIALIZED 发送到 BrowseCallback 函数时) |
SelChanged |
当选择更改时触发(当 BFFM_INITIALIZED 发送到 BrowseCallback 函数时) |
ValidateFailed |
当用户键入的文本的验证失败时触发(当 BFFM_INITIALIZED 发送到 BrowseCallback 函数时) |
BrowseFlags
是一个具有 Flags 属性集枚举,可以是以下任何值的组合:-
ReturnOnlyFSDirs
|
与 BIF_RETURNONLYFSDIRS 相同 |
DontGoBelowDomain
|
与 BIF_DONTGOBELOWDOMAIN 相同 |
ShowStatusText
|
与 BIF_STATUSTEXT 相同 |
ReturnFSancestors
|
与 BIF_RETURNFSANCESTORS 相同 |
EditBox
|
与 BIF_EDITBOX 相同 |
Validate
|
与 BIF_VALIDATE 相同 |
NewDialogStyle
|
与 BIF_NEWDIALOGSTYLE 相同 |
BrowseIncludeURLs
|
与 BIF_BROWSEINCLUDEURLS 相同 |
AddUsageHint
|
与 BIF_UAHINT 相同 |
NoNewFolderButton
|
与 BIF_NONEWFOLDERBUTTON 相同 |
BrowseForComputer
|
与 BIF_BROWSEFORCOMPUTER 相同 |
BrowseForPrinter
|
与 BIF_BROWSEFORPRINTER 相同 |
IncludeFiles
|
与 BIF_BROWSEINCLUDEFILES 相同 |
ShowShareable
|
与 BIF_SHAREABLE 相同 |