Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Collapse]Data Grid
   [Expand]Getting Started
   [Expand]Data Binding
   [Collapse]Views
    [Expand]Grid View
     Banded Grid Views
    [Expand]Card and Layout Views
     WinExplorer View
    [Expand]Tile View
   [Expand]Data Editing and Validation
   [Expand]Grouping
   [Expand]Sorting
   [Expand]Filter and Search
   [Expand]Summaries
   [Expand]Focus and Selection Handling
    Formatting Cell Values
   [Expand]Master-Detail Relationships
   [Expand]Asynchronous Image Load
   [Expand]Export and Printing
   [Expand]Appearance and Conditional Formatting
    Split Presentation
    Row Preview Sections
    Scrolling
   [Expand]Batch Modifications
   [Expand]Hit Information
    Hints
   [Expand]Popup Menus
   [Expand]Saving and Restoring Layouts
   [Expand]Visual Elements
   [Expand]Design-Time Features
   [Expand]Examples
   [Expand]End-User Capabilities
    Included Components
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core 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]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

WinExplorer View

The WinExplorer View (the WinExplorerView) is a Data Grid View optimized for showing image-containing records. The View provides eight styles to represent data similarly to the way Windows Explorer does.

Expanded View Styles

The WinExplorer View features seven unique display modes or styles for its records. These styles specify what data each record shows and how it is presented on-screen. To select the currently active view style, utilize the WinExplorerViewOptionsView.Style property.

Expanded Column Set

A newly created WinExplorer View displays nothing at runtime even if the Data Grid is bound to a source. To have the View show data, select the data fields you want to show. To do so, expand the WinExplorerView.ColumnSet property in the VS Property Grid and assign automatically generated grid columns to the required properties.

Unlike regular Views that use columns or card fields to display any number of data source fields, the WinExplorer View's records are limited to a maximum of four data portions: an image, a short title, a detailed description and a check box.

Two additional properties in the ColumnSet group allow you to organize records in groups and/or render specific records disabled.

Expanded View and View Style Settings

The WinExplorerView.OptionsView property provides access to common View settings.

You can also specify unique settings for each individual View style. To do so, expand the WinExplorerView.OptionsViewStyles property and access properties exposed by the required sub-group.

Expanded Images

The table below describes all types of images the WinExplorer View supports.

Image type
Default size
(in pixels)
View styles
that utilize these images
Related ColumnSet Property
Small 16x16 Small, List WinExplorerViewColumns.SmallImageColumn
Medium 48x48 Medium, Content, Tiles WinExplorerViewColumns.MediumImageColumn
Large 98x98 Large WinExplorerViewColumns.LargeImageColumn
Extra Large 256x256 Extra Large WinExplorerViewColumns.ExtraLargeImageColumn

Note that you do not need to assign image columns to all four properties - if there are no images of a size that the currently applied style requires, the View automatically scales images taken from other columns.

In View style settings, utilize the WinExplorerViewStyleOptions.ImageSize property to change the default image size for this View style.

Expanded Stub Glyphs

Instead of regular images, the WinExplorer View can display auto-generated images called stub glyphs. These are colored squares or circles with one or two initial letters of record title strings.

Related API

Expanded Asynchronous Image Load

Activating the Asynchronous Image Load mode allows you to do the following:

  • force the view to load images dynamically, on-demand, rather than all images at once;
  • retrieve images from the data source and manually transform them;
  • assign your own images from an external source;
  • display images with animation effects and show animated indicators for those images that are not yet ready.

Expanded Context Buttons

The WinExplorer records can display context buttons along their top and bottom sides. These buttons are by default visible only for hovered records.

To add context buttons, invoke the Collection Editor dialog by clicking the ellipsis button next to the WinExplorerView.ContextButtons property. The combo-box editor of this dialog allows you to add items of three types:

  • ContextButton - a regular push button that performs actions when clicked. With no glyph assigned, such buttons serve as labels;
  • CheckContextButton - check buttons that toggle their checked/unchecked states when clicked;
  • RatingContextButton - items that allow end-users to rate this item based on a default five-star grade.

Related API

  • TopPanelColor, BottomPanelColor - these properties, accessed through the WinExplorerView.ContextButtonOptions group specify colors for top and bottom panels that host context buttons. Use 4-number ARGB values to assign semi-transparent colors.
  • ContextItem.Visibility - specifies whether this button is always visible or only when the parent record is hovered (default behavior). If a button is constantly visible, its underlying button panel is shown as well. With this feature, you can clear the WinExplorerViewColumns.TextColumn property to replace default record titles with context buttons.

    This image demonstrates a WinExplorer View record with a caption inside the record itself. A code sample for this task can be found later in this section.

  • WinExplorerView.ContextButtonClick - occurs when end-users click context buttons.
  • WinExplorerView.ContextButtonCustomize - handle this event to modify context buttons for individual records.

    The code below illustrates how to turn a regular context button into a label that shows a model name and a trademark for car records.

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