How to: Access the Transition Manager

• Feb 24, 2022
• 2 minutes to read

This topic demonstrates how to access the Transition Manager used to animate the transition on OfficeNavigationBar root groups switching when the OutlookStyleMainRibbonForm Template is used in a WinForms application.

Tip

A complete sample project is available in the DevExpress Code Examples database at https://supportcenter.devexpress.com/ticket/details/t392403/how-to-access-the-transition-manager.

Perform the following steps to access the TransitionManager object and customize its settings.

1. Create a new WindowController in your WinForms module.
2. Override the Controller’s OnActivated method, get the OfficeNavBarTransitionController using the Frame.GetController<ControllerType> method and subscribe to the OfficeNavBarTransitionController.CustomizeTransition event.
3. To access the TransitionManager object in the CustomizeTransition event handler, use the e.TransitionManager parameter.
4. Unsubscribe from the CustomizeTransition event in the overridden OnDeactivated method when the Controller is deactivated.
5. In the CustomizeTransition event handler, assign the Transitions.TransitionType property to the newly created object of the CombTransition type.

C#

using DevExpress.ExpressApp.Win.SystemModule;
using DevExpress.Utils.Animation;
//...
public class TransitionCustomizationController : WindowController
{
    private OfficeNavBarTransitionController officeNavBarTransitionController;

    private void OnCustomizeTransition(object sender, CustomizeTransitionEventArgs e) {
        e.TransitionManager.Transitions[e.TransitionControl].TransitionType = new CombTransition();
    }
    protected override void OnActivated() {
        base.OnActivated();
        OfficeNavBarTransitionController officeNavBarTransitionController = Frame.GetController<OfficeNavBarTransitionController>();
        if(officeNavBarTransitionController != null) {
            officeNavBarTransitionController.CustomizeTransition += OnCustomizeTransition;
        }
    }
    protected override void OnDeactivated() {
        if(officeNavBarTransitionController != null) {
            officeNavBarTransitionController.CustomizeTransition -= OnCustomizeTransition;
        }
        base.OnDeactivated();
    }
    public TransitionCustomizationController() {
        TargetWindowType = WindowType.Main;
    }
}

VB.NET

Imports DevExpress.ExpressApp.Win.SystemModule
Imports DevExpress.Utils.Animation
//...
Public Class TransitionCustomizationController
    Inherits WindowController

    Private officeNavBarTransitionController As OfficeNavBarTransitionController

    Private Sub OnCustomizeTransition(ByVal sender As Object, ByVal e As CustomizeTransitionEventArgs)
        e.TransitionManager.Transitions(e.TransitionControl).TransitionType = New CombTransition()
    End Sub
    Protected Overrides Sub OnActivated()
        MyBase.OnActivated()
        Dim officeNavBarTransitionController As OfficeNavBarTransitionController = Frame.GetController(Of OfficeNavBarTransitionController)()
        If officeNavBarTransitionController IsNot Nothing Then
            AddHandler officeNavBarTransitionController.CustomizeTransition, AddressOf OnCustomizeTransition
        End If
    End Sub
    Protected Overrides Sub OnDeactivated()
        If officeNavBarTransitionController IsNot Nothing Then
            RemoveHandler officeNavBarTransitionController.CustomizeTransition, AddressOf OnCustomizeTransition
        End If
        MyBase.OnDeactivated()
    End Sub
    Public Sub New()
        TargetWindowType = WindowType.Main
    End Sub
End Class

Run the application to ensure that the transition type was changed.