ThemedWindow Class

A window that supports DevExpress WPF themes and Ribbon/Tab control integration.

Namespace: DevExpress.Xpf.Core

Assembly: DevExpress.Xpf.Core.v24.1.dll

NuGet Package: DevExpress.Wpf.Core

Declaration

C#

public class ThemedWindow :
    Window,
    IRibbonWindow,
    IHeaderItemsControlHost,
    IBackButtonSupport,
    IWindowSurrogate

VB.NET

Public Class ThemedWindow
    Inherits Window
    Implements IRibbonWindow,
               IHeaderItemsControlHost,
               IBackButtonSupport,
               IWindowSurrogate

Related API Members

The following members return ThemedWindow objects:

• ThemedWindowDialogButton.Window

Remarks

The ThemedWindow is a Window class descendant that supports DevExpress WPF themes.

Enable ThemedWindow

In Code

Follow the steps below to replace the standard Window class with the ThemedWindow:

1. Change this:

   C#

   public partial class MainWindow : Window {
        //...
   }
   

   VB.NET

   Public Partial Class MainWindow
       Inherits Window
   End Class
   

   to this:

   C#

   using DevExpress.Xpf.Core;
   public partial class MainWindow : ThemedWindow {
        //...
   }
   

   VB.NET

   Imports DevExpress.Xpf.Core
   
   Public Partial Class MainWindow
       Inherits ThemedWindow
   End Class
   

2. Change this:

   XAML

   <Window x:Class="Example.MainWindow"
   

   to this:

   XAML

   <dx:ThemedWindow x:Class="Example.MainWindow"
   

3. Add the missing reference:

   XAML

   xmlns:dx="http://schemas.devexpress.com/winfx/2008/xaml/core"
   

With the Smart Tag

Select a window, click its Smart Tag, and click Convert to ThemedWindow. This converts the current Window to the ThemedWindow and updates XAML and CS files:

Integrate the Ribbon / Tab Control

Add the RibbonControl or TabControl to your application and specify the ThemedWindow.WindowKind property to integrate the control into the ThemedWindow:

XAML

<dx:ThemedWindow 
        ...
        xmlns:dx="http://schemas.devexpress.com/winfx/2008/xaml/core"
        xmlns:dxr="http://schemas.devexpress.com/winfx/2008/xaml/ribbon"
        WindowKind="Auto">
    <Grid>
        <dxr:RibbonControl RibbonStyle="Office2010">
            <!-- RibbonControl content -->
        </dxr:RibbonControl>
    </Grid>
</dx:ThemedWindow>

Note

The RibbonControl parent element’s Background property must be set to null.

If a RibbonControl is integrated to the ThemedWindow, you can show a search box to look for Ribbon items. For more information, refer to the following help topic: SearchItemDisplayMode:

Customize the ThemedWindow

Acrylic Effect

Acrylic makes the ThemedWindow (including title bar) translucent to add a depth effect.

Set the ThemedWindow.EnableAcrylic to true to enable the Acrylic effect. You can use the ThemedWindow.AcrylicOpacity and ThemedWindow.AcrylicColor properties to customize ThemedWindow opacity and color.

Header / Toolbar Items

The ThemedWindow allows you to display items in the window’s header area:

Refer to the ThemedWindow.HeaderItems or ThemedWindow.ToolbarItems property descriptions for a code sample.

Full Height Side Panel

The ThemedWindow can display a container at its left side (Side Panel). This panel occupies the entire window height. All header elements (window icon, title, items, and so on) are displayed to the right of the Side Panel. Set the ShowLeftPanel property to true to display the Side Panel.

LeftPanelContent, LeftPanelContentTemplate, and LeftPanelContentTemplateSelector properties allow you to specify panel content.

Refer to the LeftPanelContent property description for a code sample.

Header Colors

You can use the ThemedWindow.HeaderBackground and ThemedWindow.HeaderForeground properties to specify Header Background and Foreground colors when the window is active.

XAML

<dx:ThemedWindow
    ...
    HeaderBackground="DodgerBlue"
    HeaderForeground="White">
    ...
</dx:ThemedWindow>

Glow Colors

Set ThemedWindow.UseGlowColors to true to use custom colors for the window’s glow effect. Use the ThemedWindow.ActiveGlowColor and ThemedWindow.InactiveGlowColor properties to specify glow effect colors for active and inactive windows.

Note

The ThemedWindow.UseGlowColors is in effect only if the ThemedWindow.ShowGlow property is true.

Window Buttons

Use the ThemedWindow.ControlBoxButtonSet property to specify which buttons are displayed in the window’s control box:

XAML

<dx:ThemedWindow
  ...
  xmlns:dx="http://schemas.devexpress.com/winfx/2008/xaml/core"
  ControlBoxButtonSet="Close,MaximizeRestore">
  ...
</dx:ThemedWindow>

Round Corners

Set the static RoundCorners property to true to round ThemedWindow corners.

App.xaml.cs

using DevExpress.Xpf.Core;
//...

public partial class App {
    protected override void OnStartup(StartupEventArgs e) {
        base.OnStartup(e);
        ThemedWindow.RoundCorners = true;  
    }
}

App.xaml.vb

Imports DevExpress.Xpf.Core

Public Partial Class App
    Protected Overrides Sub OnStartup(ByVal e As StartupEventArgs)
        MyBase.OnStartup(e)
        ThemedWindow.RoundCorners = True
    End Sub
End Class

Save and Restore the ThemedWindow

You can use the CurrentWindowSerializationBehavior to serialize/deserialize ThemedWindow settings. Refer to the behavior description for more information and examples.

The WindowRestoreLayoutOptions class contains attached properties that allow you to modify the deserialization process.

ThemedWindowDialog

Use the ShowDialog method overloads to display a ThemedWindowDialog.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ThemedWindow class.

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.

XAML

wpf-bind-gridcontrol-to-dynamic-data/CS/ExpandoObject/MainWindow.xaml#L1

<dx:ThemedWindow
    x:Class="ExpandoObject.MainWindow"

wpf-data-grid-implement-crud-operations/CS/GridControlCRUDSimple/MainWindow.xaml#L1

<dx:ThemedWindow x:Class="GridControlCRUDSimple.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

wpf-scheduler-specify-custom-edit-and-recurrence-dialogs/CS/CustomMvvmFormWithRecurrenceExample/MainWindow.xaml#L1

<dx:ThemedWindow
    x:Class="CustomMvvmFormWithRecurrenceExample.MainWindow"

XPO_how-to-bind-data-to-wpf-controls-using-xpservermodeview-or-xpinstantfeedbackview/CS/WpfApplication/ProgressWindow.xaml#L1

<dx:ThemedWindow
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

wpf-docklayoutmanager-use-services-that-implement-the-idocumentmanagerservice/CS/DXDocumentUIServiceSample/MainWindow.xaml#L1

<dx:ThemedWindow x:Class="DXDocumentUIServiceSample.MainWindow"
                 xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

Inheritance

Show 18 items

Object

DispatcherObject

DependencyObject

Visual

UIElement

FrameworkElement

Control

ContentControl

Window

ThemedWindow

DocumentPreviewWindow

AppointmentWindow

DeleteOccurrenceWindow

EditOccurrenceWindow

GotoDateWindow

RecurrenceWindow

RemindersWindow

TimeRulerWindow