Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Expand]Controls and Libraries
 [Collapse]Common Features
  [Expand]Data Binding Common Concepts
  [Expand]Data Source Wizard
  [Expand]Expressions
  [Collapse]Behaviors
    File and Folder Browser Behaviors
    Persistence Behavior
    Indicator Behaviors
    Stub Glyph Behavior
    Banner Behavior
    Drag And Drop Behavior
    Snap Window Behavior
  [Expand]Application Appearance
  [Expand]Filtering UI Context
  [Expand]High DPI Support
  [Expand]Scaffolding Wizard
  [Expand]Formatting Values
   HTML Text Formatting
  [Expand]Menus
  [Expand]Tooltip Management
  [Expand]Saving and Restoring Layouts
   Clipboard - Copy Data and Formatting
   Version Compatibility: Default Property Values
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

File and Folder Browser Behaviors

This document gathers multiple similar behaviors that solve various tasks related to browsing and selecting files and folders.

Expanded File Icon Behavior

This behavior checks the displayed text of a target control and if this text is a path to an existing file or folder, adds its icon to the control. The following figure illustrates multiple label controls with this behavior attached to them.

Supported controls

Behavior options

  • ShowIcon - enables or disables the behavior.
  • IconSize - allows you to select the required size for file (folder) images: small, medium, large or extra large.

    The default height of text box editors equals 20 pixels, which allows them to display only small icons. To display icons of other sizes, turn the RepositoryItem.AutoHeight property off and increase the editor's height by using the Size property.

  • InvalidPathImage - an icon that will be displayed when the target control does not display a valid file (folder) path. The assigned image is shown as is and does not scale in accordance to the IconSize setting.

Expanded File Path Behavior

Provides an auto-complete feature for the editor this behavior is attached to. Using this feature end-users can quickly enter file and/folder paths. Once a valid path is entered, its icon is displayed next to the editor's text.

To navigate through proposed auto-complete options, end-users can press Tab.

Supported controls

Behavior options

  • IconSize, InvalidPathImage - same as for the File Icon Behavior.
  • Mode - specifies whether the auto-complete feature proposes only folder paths, only file paths or both of them.
  • Filter - allows you to narrow auto-complete hints to a specific folder or file. For example, if this property is set to "Windows\Globalization\Time Zone", browsing the folder hierarchy on a system disc drive will instantly bring end-users to this folder.

Expanded Open File and Open Folder Behaviors

These behaviors instantly turn your editor into a file or a folder selector. The editor button invokes a dialog that allows you to select a file or a folder, depending on which behavior you have attached. The path and the icon of the object selected in this dialog are then shown by the editor.

Supported controls

Behavior options

How would you rate this topic?​​​​​​​