The requested page is not available for the requested platform. You are viewing the content for Default platform.

Theme Upgrade

We here at DevExpress are constantly working on improving the visual appearance of our products. For this purpose, we may modify and/or refactor our themes between major and minor releases. Custom themes created for an earlier version of the DXperience Suite may not be consistent with controls of the latest version due to these changes.

The Theme Editor allows you to upgrade your themes to keep them compatible with latest DXperience versions.

To upgrade a theme, the Theme Editor uses the KDiff3 tool that performs three-way merge upon:

  • your custom theme of the old version (file 'B');
  • the original DevExpress theme of the latest version (file 'C');
  • the original DevExpress theme of the old version (the parent theme stored within your custom theme) (file 'A').
Note

You can upgrade only themes created with Theme Editor v11.2.11 and newer because previous versions of the Theme Editor did not save parental DevExpress themes within user themes.

You cannot upgrade themes created from Color Schemes. Instead, upgrade the base theme and apply a color scheme to it. Do not remove the base theme, because it is necessary for a theme upgrade to a newest version.

To upgrade a theme, follow the steps below.

  1. Open the File menu and select Upgrade Theme.

    CommonTasks_UpgradeTheme_Menu

    This invokes the Upgrade Theme dialog.

    CommonTasks_UpgradeThemeForm

  2. In this dialog, choose a theme you wish to upgrade and specify an output directory for the upgraded theme. You can use the Browse buttons or specify the required paths manually. In the Target Version combo box, select a version to which you wish to upgrade the theme. Finally, click OK.

    CommonTasks_UpgradeThemeForm_Filled

    This will start the KDiff3 tool.

    CommonTasks_UpgradeTheme_Kdiff

  3. In the KDiff3 window, open the Directory menu and click Start/Continue Directory Merge.

    CommonTasks_UpgradeTheme_Kdiff_StartMerge

    A confirmation message box appears. Click Do It.

    CommonTasks_UpgradeTheme_Kdiff_ConfirmMerge

    KDiff3 will start merging XAML files.

  4. If a conflict that requires manual resolving occurs, KDiff3 will display 'A', 'B' and 'C' XAML files and highlight the conflicting pieces of code.

    CommonTasks_UpgradeTheme_Conflict

    To resolve the conflict, right-click the <Merge Conflict> tag in the Output section and choose whether to insert code from file 'A', 'B' or 'C'.

    CommonTasks_UpgradeTheme_Conflict_Resolve

    Open the Directory menu and click Start/Continue Directory Merge to continue merging. This will invoke a message box where you would specify whether or not to save changes. Click Save & Continue.

    CommonTasks_UpgradeTheme_Conflict_SaveChanges

  5. When merging is completed, a finish message box will be displayed.

    CommonTasks_UpgradeTheme_Finished

    Click OK and close the KDiff3 tool, so that the Theme Editor makes final arrangements. Now the upgraded theme is located within the directory you have specified.

Note

For more information, please refer to the online documentation on KDiff3. For instance, you may search for "The KDiff3 Handbook".