Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[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]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Collapse]eXpressApp Framework
 [Expand]Fundamentals
 [Expand]Getting Started
 [Collapse]Concepts
  [Expand]Application Solution Components
  [Expand]Business Model Design
  [Expand]Application Model
  [Collapse]UI Construction
    UI Element Overview
    Windows and Frames
   [Collapse]Templates
     Template Customization
    Action Containers
   [Expand]Views
   [Expand]View Items
    List Editors
    Add and Override Images
    Text Notifications
    Ways to Show a Confirmation Dialog
    ASP.NET Web Application Appearance
    Application Personalization
    Using a Custom Control that is not Integrated by Default
  [Expand]Extend Functionality
  [Expand]Data Manipulation and Business Logic
  [Expand]Security System
  [Expand]Localization
  [Expand]System Module
  [Expand]Extra Modules
  [Expand]Debugging and Error Handling
  [Expand]Filtering
  [Expand]Application Life Cycle
 [Expand]Design-Time Features
 [Expand]Functional Testing
 [Expand]Deployment
 [Expand]Task-Based Help
  Frequently Asked Questions
 [Expand]API Reference
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Templates

Templates define what Windows and Frames look like. For instance, built-in Templates contain Action Containers and a View site. When you build an application, ready-to-use Templates help you concentrate on the business model and logic, instead of having to create a UI from scratch. If necessary, you can customize the default Templates or replace them with your own. This topic describes the built-in Template types. Refer to the Template Customization topic to learn how to customize the default Templates.

A Template is a control that implements the IFrameTemplate or IWindowTemplate interface. These interfaces provide methods that specify a Template's Action Containers collection, and assign a View to be displayed. The IWindowTemplate interface is inherited from the IFrameTemplate interface. The difference is that the IWindowTemplate interface additionally provides a store for status messages, a Template's caption and a flag indicating whether or not it should be sizeable. This means that a Template that implements the IWindowTemplate interface behaves like a standard form.

The controls that are used to display List and Detail Views support end-user customization. For instance, in WinForms applications, end-users can customize the layout of toolbars, columns in grid controls, controls in detail forms, etc. All built-in Windows Forms Templates are designed to save these end-user customizations to the Application Model, so changes made will persist between application runs.

The eXpressApp Framework uses built-in Templates for automatic UI construction in WinForms, ASP.NET Web and Mobile applications. These Templates are listed below.

Expanded WinForms Application Templates

Image Description

Class: MainForm, Namespace: DevExpress.ExpressApp.Win.Templates.

Displays the main Window. To use this template, set the IModelOptionsWin.FormStyle property to Standard.

Class: LightStyleMainForm, Namespace: DevExpress.ExpressApp.Win.Templates.

Displays the main Window without excessive borders. To use this template, set the IModelOptionsWin.FormStyle property to Standard and WinApplication.UseLightStyle to true.

Class: MainRibbonFormV2, Namespace: DevExpress.ExpressApp.Win.Templates.Bars.

Displays the main Window with the Ribbon form style. To use this template, set the IModelOptionsWin.FormStyle property to Ribbon.

Class: LightStyleMainRibbonForm, Namespace: DevExpress.ExpressApp.Win.Templates.

Displays the main Window with the Ribbon form style without excessive borders. To use this template, set the IModelOptionsWin.FormStyle property to Ribbon and WinApplication.UseLightStyle to true.

Class: OutlookStyleMainRibbonForm, Namespace: DevExpress.ExpressApp.Win.Templates.Ribbon.

Used to display the main Window with the Outlook form style. To use this template, set the IModelOptionsWin.FormStyle property to Ribbon and IModelRootGroupsStyle.RootGroupsStyle to OutlookSimple or OutlookAnimated.

Class: DetailViewForm, Namespace: DevExpress.ExpressApp.Win.Templates.

Displays a Detail View in a new Window. To use this template, set the IModelOptionsWin.FormStyle property to Standard.

Class: DetailRibbonFormV2, Namespace: DevExpress.ExpressApp.Win.Templates.Bars.

Displays a Detail View in a new Window with the Ribbon form style. To use this template, set the IModelOptionsWin.FormStyle property to Ribbon.

Class: PopupForm, Namespace: DevExpress.ExpressApp.Win.Templates.

Used to display pop-up windows with a Detail View. For instance, a logon form is displayed by the PopupForm Template.

Class: LookupForm, Namespace: DevExpress.ExpressApp.Win.Templates.

Used to display pop-up windows with a List View. For instance, PopupWindowShowAction type Actions use the LookupForm Template to display their pop-up window.

Class: LookupControlTemplate, Namespace: DevExpress.ExpressApp.Win.Templates.

Used to display a Lookup Property Editor's drop down window.

Class: NestedFrameTemplate, Namespace: DevExpress.ExpressApp.Win.Templates.

Used to display a Window or Frame nested into another Window or Frame. For instance, a List Property Editor or Detail Property Editor's window is displayed by the NestedFrameTemplate Template.

Note

Refer to the Toggle the WinForms Ribbon Interface topic to learn how to toggle a Ribbon user interface in your WinForms application.

Expanded ASP.NET Web Application Templates

Image

Description

Class: DefaultVerticalTemplateContentNew, Namespace: DevExpress.ExpressApp.Web.Templates.

Used to display the main Window and Detail View Windows (both in view and edit modes).

Class: DialogTemplateContentNew, Namespace: DevExpress.ExpressApp.Web.Templates.

Used to display a dialog window (e.g., a Lookup Property Editor's drop down window or a PopupWindowShowAction's pop-up window).

Class: FindDialogTemplateContentNew, Namespace: DevExpress.ExpressApp.Web.Templates.

Used to display a dialog window (e.g., a Lookup Property Editor's drop down window or a PopupWindowShowAction's pop-up window) with the records filter.

Class: NestedFrameControlNew, Namespace: DevExpress.ExpressApp.Web.Templates.

Used to display a Window (Frame) nested into another Window (Frame), such as a List Property Editor or Detail Property Editor's Frame.

Class: LogonTemplateContentNew, Namespace: DevExpress.ExpressApp.Web.Templates.

Used to display a logon Window.

Note

If you use a classic ASP.NET web application style, and want to use the new style instead, call the WebApplication.SwitchToNewStyle method.

Expanded Mobile Application Template

Image

Description

Class: MobileWindowTemplate, Namespace: DevExpress.ExpressApp.Mobile.Templates.

Used to display all Windows in accordance with the SPA technology.

Expanded Classic ASP.NET Web Application Templates

Image

Description

Class: DefaultVerticalTemplateContent, Namespace: DevExpress.ExpressApp.Web.Templates.

Can be used to display the main Window and Detail View Windows (both in view and edit modes). This Template is the main window's standard template with the vertical navigation bar. To learn how to use this template, refer to the ASP.NET Web Application Appearance topic.

Class: DefaultTemplateContent, Namespace: DevExpress.ExpressApp.Web.Templates.

Used to display the main Window and Detail View Windows (both in view and edit modes). This Template is an optional template that has horizontally aligned navigation tabs that conserve the main window's space.

Class: DialogTemplateContent, Namespace: DevExpress.ExpressApp.Web.Templates.

Used to display a dialog window (e.g., a Lookup Property Editor's drop down window or a PopupWindowShowAction's pop-up window).

Class: NestedFrameControl, Namespace: DevExpress.ExpressApp.Web.Templates.

Used to display a Window (Frame) nested into another Window (Frame), such as a List Property Editor or Detail Property Editor's Frame.

Class: LogonTemplateContent, Namespace: DevExpress.ExpressApp.Web.Templates.

Used to display a logon Window. Contains the PopupActions Action Container.

Class: ErrorInfoControl, Namespace: DevExpress.ExpressApp.Web.Templates.Controls.

Used to display a Window with a comment about an error.

Note

If you use a new ASP.NET web application theme, and want to use the classic style instead, call the WebApplication.SwitchToOldStyle method.

Expanded See Also

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