Skip to main content
All docs
V25.1
  • WindowsFormsSettings.OptimizeRemoteConnectionPerformance Property

    Gets or sets whether the application should disable various visual effects to enhance the performance when accessed over slow remote connections.

    Namespace: DevExpress.XtraEditors

    Assembly: DevExpress.Utils.v25.1.dll

    NuGet Packages: DevExpress.Utils, DevExpress.Wpf.Core

    Declaration

    public static DefaultBoolean OptimizeRemoteConnectionPerformance { get; set; }

    Property Value

    Type Description
    DefaultBoolean

    Specifies whether the remote connection optimization is on. The Default value is equal to false.

    Available values:

    Name Description Return Value
    True

    The value is true.

    0

    False

    The value is false.

    1

    Default

    The value is specified by a global option or a higher-level object.

    2

    Remarks

    When enabled, this property minimizes the amount of visual effects and animations. This allows applications to reduce traffic consumption and improve overall performance in remote environments.

    The OptimizeRemoteConnectionPerformance property has the following effects:

    Animations

    • Transition animations managed by the TransitionManager.
    • FadeIn and FadeOut effects of splash screens.
    • Bar item link hover animations. Enable the AllowLinkLighting to turn on this animation effect.
    • Various expand/collapse, sort, drag-and-drop, and other animations that follow end-user actions. Enable the static AnimationMode property to turn these animations back on.

    Shadows

    • Shadows cast by XtraForm, XtraDialog and XtraMessageBox. Call the static EnableWindowShadows() method to restore them.
    • Bar sub-menu shadows. Enable the SubmenuHasShadow property to display these shadows.

    Other effects

    • XtraForms display thick borders for a better drag-and-resize experience. You can disable the FormThickBorder property to keep thin form borders, or modify the ThickBorderWidth property to change their thickness.
    • Scroll paint operations are delayed for 75ms.
    • Acrylic Material and Reveal Highlight effects for Fluent Design Forms are disabled. Set the SurfaceMaterial property to Acrylic to enable these effects.

    Tip

    To maximize performance, we recommend that you apply a flat vector skin (for instance, “Bezier” or “Basic”). Skins with gradient bitmaps (such as “Valentine” or “Caramel”) generate more traffic and can negatively impact the user experience.

    How to use the property and override its settings

    Enable the OptimizeRemoteConnectionPerformance property when the SystemInformation.TerminalServerSession property returns true:

    WindowsFormsSettings.OptimizeRemoteConnectionPerformance = 
        SystemInformation.TerminalServerSession ? DefaultBoolean.True : DefaultBoolean.False;
    

    When the OptimizeRemoteConnectionPerformance property changes its value, the LookAndFeel.Default.StyleChanged event fires. You can handle this event to re-enable animations that you wish to keep:

    DevExpress.LookAndFeel.UserLookAndFeel.Default.StyleChanged += Default_StyleChanged;
    
    void Default_StyleChanged(object sender, EventArgs e) {
        var reason = (e as LookAndFeelChangedEventArgs).Reason;
        if (reason == LookAndFeelChangeReason.OptimizeRemoteConnectionPerformanceChanged) {
            //fine-tune animations and effects
            //for example
            //WindowsFormsSettings.EnableWindowShadows();
            //barManager1.Controller.PropertiesBar.AllowLinkLighting = true;
        }
    }
    
    See Also