ThemedWindow Class

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

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

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

Declaration

C#
VB.NET

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

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

The following members return ThemedWindow objects:

Remarks

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

ThemedWindow-ribbon-tab

Enable ThemedWindow

In Code

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

Change this:

C#
VB.NET

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

Public Partial Class MainWindow
    Inherits Window
End Class

to this:

C#
VB.NET

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

Imports DevExpress.Xpf.Core

Public Partial Class MainWindow
    Inherits ThemedWindow
End Class

Change this:

XAML

<Window x:Class="Example.MainWindow"

to this:

XAML

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

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:

SmartTagsConvertTo

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.

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 the ThemedWindow’s opacity and color.

WPF Acrylic Window - Color Property

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

WPF Themed Window - Header / Toolbar Items

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

Header Colors

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

WPF Themed Window - Header Background / Foreground

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 a glow effect colors for active and inactive windows.

WPF Themed Window - Glow Colors

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:

ThemedWindow ControlboxButtonsSet Property Result

XAML

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

ThemedWindowDialog

Use the ShowDialog method overloads to display a ThemedWindowDialog.

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-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"

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

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

How-to-validate-appointment-items-on-adding-or-editing-them-in-SchedulerControl/CS/DXSample/MainWindow.xaml#L1

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

how-to-replace-standard-dxrichedit-command-with-your-own-custom-command-t466861/CS/DXApplication36/MainWindow.xaml#L1

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

wpf-spreadsheet-how-to-perform-a-mail-merge-t618180/CS/WpfSpreadsheetMailMerge/MainWindow.xaml#L1

<dx:ThemedWindow x:Class="WpfSpreadsheetMailMerge.MainWindow" mc:Ignorable="d" Title="Spreadsheet" Height="600" Width="800"
    xmlns:dx="http://schemas.devexpress.com/winfx/2008/xaml/core"