Skip to main content

Managing themes in WPF

Having just published Simple.Wpf.Terminal as a nuget package I wanted the ability to skin the user control - the more flexibility in the way it looks the more likely it will be used by other devs :)

Before getting into the detail, lets look at the solution working in the test harness for my WPF F# REPL Engine, shown below are four different themes applied dynamically at run-time - no recompilation required to change the theme:
Previously in larger WPF apps I've relied upon third-party control vendors like Telerik to provide theming support. Typically they provide good solutions to the problem with multiple themes supported as standard, and when you're already using their third party controls the use of their themes makes sense. But when you're developing a small UI component you don't want to add (& support) such a large footprint just to add themes to your niche control.

A theme is a collection of Styles grouped into a ResourceDictionary in WPF. A Style can be applied to a control type, this is done either via the target type of via name (Key). Shown below is a very simple there with two styles defined, hopefully they are obvious but if not these two styles are targeting the Button & TextBlock controls:
A theme (resource dictionary) is then applied either at the application level to all controls in the visual tree or at the control level to all controls lower in the visual tree - scoping the theme to only a part of the visual tree.

How you apply the theme is what makes managing themes interesting, typically in an app which doesn't support changing the theme at run-time this would be done statically at compile time using XAML:
But this approach won't work when you want to be able to change the theme dynamically at run-time, you need to do this in code behind, and this is where a theme manager comes into play.

The solution I wanted was to provide a simple UI (combo box) allowing the user to select a theme which is then dynamically applied to the UI. The UI control manipulates a globally defined theme manager - defined globally as a static class:
The control exposes three dependency properties - ItemsSource, SelectedItem & Scope.

These allow the setting, selecting and scoping of the theme you want to apply to the app. As stated earlier the actual manipulating was done using a theme manager class, this means you aren't required to use UI (combo box) to manage themes. The theme manager implementation is shown below, as you can see it's pretty straight forward manipulation of resource dictionaries:

Loading gist ....

The following example shows how I use the control in a code-behind approach - there's an MVVM approach included in the code base on github:
 with the following code behind, note the use of the Theme class to bring to together the user friendly name and the actual URI of the resource dictionary:
 and finally the following XAML definition:
Hopefully you can see you don't need to actually use the ThemeManager class directly, this is done for you by the Theme user control.

I've pushed the code up onto github and as a nuget package.

Comments

Popular posts from this blog

Implementing a busy indicator using a visual overlay in MVVM

This is a technique we use at work to lock the UI whilst some long running process is happening - preventing the user clicking on stuff whilst it's retrieving or rendering data. Now we could have done this by launching a child dialog window but that feels rather out of date and clumsy, we wanted a more modern pattern similar to the way <div> overlays are done on the web. Imagine we have the following simple WPF app and when 'Click' is pressed a busy waiting overlay is shown for the duration entered into the text box. What I'm interested in here is not the actual UI element of the busy indicator but how I go about getting this to show & hide from when using MVVM. The actual UI elements are the standard Busy Indicator coming from the WPF Toolkit : The XAML behind this window is very simple, the important part is the ViewHost. As you can see the ViewHost uses a ContentPresenter element which is bound to the view model, IMainViewModel, it contains 3 child v

Showing a message box from a ViewModel in MVVM

I was doing a code review with a client last week for a WPF app using MVVM and they asked ' How can I show a message from the ViewModel? '. What follows is how I would (and have) solved the problem in the past. When I hear the words ' show a message... ' I instantly think you mean show a transient modal message box that requires the user input before continuing ' with something else ' - once the user has interacted with the message box it will disappear. The following solution only applies to this scenario. The first solution is the easiest but is very wrong from a separation perspective. It violates the ideas behind the Model-View-Controller pattern because it places View concerns inside the ViewModel - the ViewModel now knows about the type of the View and specifically it knows how to show a message box window: The second approach addresses this concern by introducing the idea of messaging\events between the ViewModel and the View. In the example below

Custom AuthorizationHandler for SignalR Hubs

How to implement IAuthorizationRequirement for SignalR in Asp.Net Core v5.0 Been battling this for a couple of days, and eventually ended up raising an issue on Asp.Net Core gitHub  to find the answer. Wanting to do some custom authorization on a SignalR Hub when the client makes a connection (Hub is created) and when an endpoint (Hub method) is called:  I was assuming I could use the same Policy for both class & method attributes, but it ain't so - not because you can't, because you need the signatures to be different. Method implementation has a resource type of HubInnovationContext: I assumed class implementation would have a resource type of HubConnectionContext - client connects etc... This isn't the case, it's infact of type DefaultHttpContext . For me I don't even need that, it can be removed completely  from the inheritence signature and override implementation. Only other thing to note, and this could be a biggy, is the ordering of the statements in th