The requested page is not available for the requested platform. You are viewing the content for Default platform.

XafApplication.CreateCustomTemplate Event

Occurs when creating a Template.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v19.1.dll

Declaration

public event EventHandler<CreateCustomTemplateEventArgs> CreateCustomTemplate
Public Event CreateCustomTemplate As EventHandler(Of CreateCustomTemplateEventArgs)

Event Data

The CreateCustomTemplate event handler receives an argument of the CreateCustomTemplateEventArgs type. The following properties provide information specific to this event.

Property Description
Application Provides access to the XafApplication object.
Context Returns the context in which a Template is created.
Template Specifies the Template which is created in a XafApplication.CreateCustomTemplate event handler.
UseDefaultTemplate Defines whether the application creates default templates on startup.

Remarks

In Windows Forms applications, this event is raised when a Window is created. Handle this event to create a custom Template for this Window. For this purpose, use the handler's CreateCustomTemplateEventArgs.Context parameter to create a custom Template for a particular context. For details, refer to the Template Customization, How to: Create a Custom WinForms Ribbon Template and How to: Create a Custom WinForms Standard Template topics.

In ASP.NET Web applications, Templates represent pages that implement the IFrameTemplate or IWindowTemplate interface. If a page which is being loaded does not implement one of these interfaces, the CreateCustomTemplate event is raised. Handle this event, to create a Web control that implements the IFrameTemplate or IWindowTemplate interface.

The CreateCustomTemplate event is triggered at an XAF WinForms application's startup, once or twice. This depends on the conditions below.

When the Event is Triggered When to Handle the Event
1 On the application's startup, before the Application Model loads. To create custom Logon or Main Window templates that do not require the Application Model. If you handle the event at this time, the application creates templates in a separate thread and demonstrates a reduced startup time.
2 On the application's startup, after the Application Model loads - if no custom templates were passed the first time the event was triggered. To get Logon or Main Window templates created the first time the event was triggered or to create templates that depend on the Application Model for their settings.
See Also