WindowTemplateController.UpdateWindowStatusMessage() Method

Refreshes the status bar messages.

Namespace: DevExpress.ExpressApp.SystemModule

Assembly: DevExpress.ExpressApp.v26.1.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

public void UpdateWindowStatusMessage()

VB.NET

Public Sub UpdateWindowStatusMessage

Remarks

The following code sample uses the UpdateWindowStatusMessage method in a custom View Controller. This controller handles the CustomizeWindowStatusMessages event to add a status message that contains the number of selected objects. When the selection changes, the UpdateWindowStatusMessage() method refreshes the status bar messages.

SolutionName.Win\Controllers\CustomizeWindowController.cs

using DevExpress.ExpressApp;
using DevExpress.ExpressApp.SystemModule;

public class UpdateWindowStatusMessagesController : ViewController<DevExpress.ExpressApp.ListView> {
    private WindowTemplateController wtController;
    public UpdateWindowStatusMessagesController() { }
    protected override void OnActivated() {
        base.OnActivated();
        wtController = Frame.GetController<WindowTemplateController>();
        wtController?.CustomizeWindowStatusMessages += wtController_CustomizeWindowStatusMessages;
    }
    protected override void OnViewControlsCreated() {
        base.OnViewControlsCreated();
        View.Editor.SelectionChanged += Editor_SelectionChanged;
    }
    protected override void OnViewControlsDestroying() {
        View.Editor.SelectionChanged -= Editor_SelectionChanged;
        base.OnViewControlsDestroying();
    }
    protected override void OnDeactivated() {
        wtController?.CustomizeWindowStatusMessages -= wtController_CustomizeWindowStatusMessages;
        wtController?.UpdateWindowStatusMessage();
        base.OnDeactivated();
    }
    void wtController_CustomizeWindowStatusMessages(object sender, CustomizeWindowStatusMessagesEventArgs e) {
        e.StatusMessages.Add(String.Format("Selected objects count: {0}", View.SelectedObjects.Count));
    }
    void Editor_SelectionChanged(object sender, EventArgs e) {
        wtController.UpdateWindowStatusMessage();
    }
}

Refer to the following help topic for details: Window Status Messages in XAF WinForms Applications.