WindowTemplateController.CustomizeWindowCaption Event

Occurs before the Window caption is updated. Allows you to change the Window caption.

Namespace: DevExpress.ExpressApp.SystemModule

Assembly: DevExpress.ExpressApp.v19.2.dll

Declaration

C#

public event EventHandler<CustomizeWindowCaptionEventArgs> CustomizeWindowCaption

VB.NET

Public Event CustomizeWindowCaption As EventHandler(Of CustomizeWindowCaptionEventArgs)

Event Data

The CustomizeWindowCaption event's data class is CustomizeWindowCaptionEventArgs. The following properties provide information specific to this event:

Property	Description
WindowCaption	Represents a Window caption.

Remarks

The WindowTemplateController event is raised before setting the Window caption text. Handle this event in a custom Window Controller, to modify a Window caption. Refer to the How to: Customize a Window Caption topic, for details. This event cannot be used to change popup window’s captions in ASP.NET applications.

Note

You can use the WindowTemplateController.UpdateWindowCaption method to refresh the Window caption.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the CustomizeWindowCaption event.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

XAF_how-to-show-an-asterisk-in-the-window-title-when-an-object-in-a-view-is-modified-e1703/CS/WinSolution.Module/DirtyTitleWindowController.cs#L13

    windowTemplateController = Window.GetController<WindowTemplateController>();
    windowTemplateController.CustomizeWindowCaption += windowTemplateController_CustomizeWindowCaption;
}

VB.NET

XAF_how-to-show-an-asterisk-in-the-window-title-when-an-object-in-a-view-is-modified-e1703/VB/WinSolution.Module/DirtyTitleWindowController.vb#L15

    windowTemplateController = Window.GetController(Of WindowTemplateController)()
    AddHandler windowTemplateController.CustomizeWindowCaption, AddressOf windowTemplateController_CustomizeWindowCaption
End Sub