MdiShowViewStrategy.GetActiveInspector() Method

Returns the active Inspector Window.

Namespace: DevExpress.ExpressApp.Win

Assembly: DevExpress.ExpressApp.Win.v23.2.dll

NuGet Packages: DevExpress.ExpressApp.Win, DevExpress.ExpressApp.Win.Design

NuGet Package: DevExpress.ExpressApp.Win

Declaration

C#

public WinWindow GetActiveInspector()

VB.NET

Public Function GetActiveInspector As WinWindow

Returns

Type	Description
WinWindow	A WinWindow object representing the active Inspector Window.

Remarks

An XAF Windows Forms application provides two types of Windows - Explorer and Inspector.

• Explorer Window - contains navigation items and can display several List and Detail Views in tabs (when the MDI is used).
• Inspector Window - does not provide navigation items and displays a single View

The following example demonstrates how to use this method in a Window Controller to access a current Window and View in MDI mode:

File:
MySolution.Win/Controllers/CustomWindowController.cs in solutions without the WinForms-specific module project. MySolution.Module.Win/Controllers/MyController.cs(.vb) in solutions with the WinForms-specific module project.

C#

using DevExpress.ExpressApp;
using DevExpress.ExpressApp.Actions;
using DevExpress.ExpressApp.Win;
using DevExpress.Persistent.Base;
// ...
public class CustomWindowController : WindowController {
    public CustomWindowController() {
        SimpleAction myAction = new SimpleAction(this, "MyAction", PredefinedCategory.View);
        myAction.Execute += MyAction_Execute;
    }
    private void MyAction_Execute(object sender, SimpleActionExecuteEventArgs e) {
        MdiShowViewStrategy strategy = Application.ShowViewStrategy as MdiShowViewStrategy;
        if (strategy != null) {
            WinWindow currentWindow = strategy.GetActiveInspector();
            if (currentWindow != null) {
                View _view = currentWindow.View;
                // custom logic
            }
        }
    }
}

VB.NET

Imports DevExpress.ExpressApp
Imports DevExpress.ExpressApp.Actions
Imports DevExpress.ExpressApp.Win
Imports DevExpress.Persistent.Base
' ...
Public Class CustomWindowController
    Inherits WindowController
    Public Sub New()
        Dim myAction As New SimpleAction(Me, "MyAction", PredefinedCategory.View)
        AddHandler myAction.Execute, AddressOf MyAction_Execute
    End Sub
    Private Sub MyAction_Execute(ByVal sender As Object, ByVal e As SimpleActionExecuteEventArgs)
        Dim strategy As MdiShowViewStrategy = TryCast(Application.ShowViewStrategy, MdiShowViewStrategy)
        If strategy IsNot Nothing Then
            Dim currentWindow As WinWindow = strategy.GetActiveInspector()
            If currentWindow IsNot Nothing Then
                Dim _view As View = currentWindow.View
                ' custom logic
            End If
        End If
    End Sub
End Class