[Expand]General Information
[Expand]WinForms Controls
[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]Office File API
[Expand]Report and Dashboard Server
[Collapse]eXpressApp Framework
 [Expand]Getting Started
  [Expand]Application Solution Components
  [Expand]Business Model Design
  [Expand]Application Model
  [Collapse]UI Construction
    UI Element Overview
    Windows and Frames
    Action Containers
   [Collapse]View Items
     Property Editors
     View Items Layout Generation
     View Items Layout Customization
    List Editors
    Ways to Access UI Elements and Their Controls
    Add and Override Images
    Text Notifications
    Ways to Show a Confirmation Dialog
    ASP.NET Web Application Appearance
    Ways to Customize a Mobile Application
    Application Personalization
    Using a Custom Control that is not Integrated by Default
    XAF Mobile Wrappers for DevExtreme Widgets
   [Expand]Splash Forms
  [Expand]Controllers and Actions
  [Expand]Data Manipulation and Business Logic
  [Expand]Security System
  [Expand]System Module
  [Expand]Extra Modules
  [Expand]Debugging, Testing and Error Handling
  [Expand]Application Life Cycle
 [Expand]Design-Time Features
 [Expand]Task-Based Help
  Frequently Asked Questions (FAQ)
 [Expand]API Reference
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

View Items

Dashboard Views and Detail Views consist of View Items - abstract UI entities represented by ViewItem class descendants. To create actual controls, each item type overrides the protected CreateControlCore method, called when an item needs to be displayed in a UI. Since different controls are used in Windows Forms, ASP.NET and Mobile applications, there are View Items individually implemented for Windows, Web and Mobile UI. These items are supplied in DevExpress.ExpressApp.Win, DevExpress.ExpressApp.Web and DevExpress.ExpressApp.Mobile assemblies respectively.

XAF provides the following basic View Item types:

Item Type



Displays an Action Container specified by the IModelActionContainerViewItem.ActionContainer property of the Application Model's corresponding ActionContainerViewItem node. Used to display Actions on a Detail View layout.


Displays a control specified by the IModelControlDetailItem.ControlTypeName property of the Application Model's corresponding ControlDetailItem node (see How to: Show a Custom Data-Bound Control in an XAF View (WinForms)). So, you can specify a control (Windows Forms, ASP.NET or Mobile) that will be displayed in a UI. This View Item type is declared in the DevExpress.ExpressApp.dll assembly and is UI independent.


Displays a a data-bound ASP.NET User Control control specified by the IModelCustomUserControlViewItemWeb.CustomControlPath property of the Application Model's corresponding CustomUserControlViewItemWeb node (see How to: Show a Custom Data-Bound Control in an XAF View (ASP.NET)).


Displays a View in a nested Frame. Used to display several Views side-by-side on a Dashboard View. Mobile applications do not support this View Item type.


Displays an editor control bound to a property. There are multiple property editor types in XAF. They are intended for different data types, and therefore use different controls. For example:

More Property Editors intended for various property types are listed in the Data Types Supported by built-in Editors section.


Displays an image.


Displays a label.

Expanded Customize View Items

You can use the following approaches to customize View Items:

Access and Customize View Items in Code

You can use the following approaches to access or customize View Items:

Customize the Application Model

The Application Model displays nodes for all View Items in your application. You can use the Application Model to customize View Items.

  • ViewItems node

    This node has child nodes that correspond to the basic View Item types. These View Items are used to construct Detail Views. Examples of these base types are Static Text, Static Image, Property Editor, etc. Each base type is actually represented in the UI by a particular descendant class. This descendant is specified via the DefaultItemType property. If there are multiple descendants available, you can select the desired class via the property's drop-down list.

    Since different data types require different Property Editors, the PropertyEditors node supplies child nodes corresponding to data types. These child nodes specify the default Property Editor for each data type, using the EditorType property.

    The following picture illustrates the ViewItems node:

  • Views | DashboardView or DetailView | Items node

    This node lists the current Detail View's items. By default, it contains only Property Editor nodes. Their PropertyEditorType property specifies the Property Editor type used in a UI. Of course, you can change the default property value by selecting another property editor type from the dropdown list.

    You can change other properties such as DisplayFormat (see PropertyEditor.DisplayFormat), EditMask (see PropertyEditor.EditMask) etc. See Format a Property Value.

    You can also add other View Items to a Detail View. To do this, use the Model Editor's context menu. If you add a Static Text, Static Image or Control item, you can use the ItemType property to specify the actual class used to represent this item in a UI.

  • Views | DashboardView or DetailView | Layout node.

    This node specifies the layout of the current View's items. Items can be grouped or located separately. You can change the default layout, by using the context menu and specifying property values in the Model Editor. In addition, the Model Editor allows you to view the resulting items layout. When the Layout node is selected, the property list to the right is displayed with a design surface that emulates the current View. To drag the View Items, right-click on the empty space, and select Customize Layout. The Customization form will be invoked. Close this form, to go back to the view mode of the emulated View.

    For details, refer to the View Items Layout Customization topic.

Create Custom View Items

You can use a custom View Item if XAF's built-in View Items do not meet your requirements. The following articles describe how to create a View Item and use it to implement additional functionality:


You can find built-in View Items from the eXpressApp Framework libraries in the Model Editor, invoked for a Windows Forms, ASP.NET or Mobile application project, since the DevExpress.ExpressApp.Win assembly is referenced in Windows Forms application projects, the DevExpress.ExpressApp.Web assembly in the Web application projects, and the DevExpress.ExpressApp.Mobile assembly in the Mobile application projects.

Expanded See Also

Is this topic helpful?​​​​​​​