Click here to Skip to main content
15,867,488 members
Articles / Desktop Programming / WPF

Organizing and Using Low Level Style Elements in WPF Resource Libraries

Rate me:
Please Sign up or sign in to vote.
4.90/5 (4 votes)
6 Apr 2020CPOL10 min read 9.8K   7   4
Explains how to set up and use colours, fonts and dimensions for re-usability in WPF applications
A bottom up approach to re-use low level style elements, like colours, margins, widths, heights and fonts to build up a re-usable library with resource dictionaries. Focus is on the low level aspects and on the way you can organize all these elements in a separate library.

Introduction

When I started creating WPF applications, I just mixed all markup directly in the WPF code. Gradually, I discovered this is not the way to go.

  • Re-use of style information is hard.
  • Changing what your application looks like is a lot of work.

This article intends to help you to create a style library that separates markup from WPF functional layout and makes re-use a bit easier. I do not claim to have a perfect solution, and would like to invite you to express your ideas and suggest improvements.

You can download a demo project from Github.

You need some knowledge on WPF (elementary) and you need a basic knowledge of Resource Dictionaries to understand this article.

Demo Application Setup

The demo application has two projects:

  • StyleDemo.DesktopUI is a WPF.NET Core 3.1 project. This is only for demo and testing purposes.
  • Styles.Library is a WPF User Control library, .NET Core 3.1 Make sure to use a user control library and not an ordinary class library.

This should work for .NET framework as well.

The Desktop UI depends on the Styles.Library project, so do not forget to include these dependencies.

You do not need any Nuget packages. I use Visual Studio Community Edition 2019, version 16.5.

Setting Up Styles.Library

The basic concept is to create a number of resource dictionaries. To avoid the need to create references to each individual dictionary, first a dictionary that collects all other dictionaries is created. I use the convention to put the term “Dictionary” in the name of each resource dictionary.

In the demo, I name it StylesDictionary.

To be able to test this, you need at least one dictionary to include in the user control library. To do this, I create three empty dictionaries:

  • ColorSchemaDictionary which will contain all colors used in the application.
  • SizeSchemaDictionary for all sizes we like to give standard values.
  • FontDictonary to define fonts.

The code for Styles.Dictionary looks like this:

XAML
<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
  <ResourceDictionary.MergedDictionaries>

    <!-- Basic markup -->
    <ResourceDictionary Source="ColorSchemaDictionary.xaml"/>
    <ResourceDictionary Source="SizeSchemaDictionary.xaml"/>
    <ResourceDictionary Source="FontDictionary.xaml"/>
  </ResourceDictionary.MergedDictionaries>
</ResourceDictionary>

Make Styles.Library Available in the UI

Now, we can make this StylesDictionary available in the desktop application. To do this, adapt App.xaml, to refer to this resource dictionary:

XAML
<Application x:Class="StyleDemo.DesktopUI.App"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             StartupUri="MainWindow.xaml">
    <Application.Resources>
      <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
          <ResourceDictionary
            Source="pack://application:,,,/Styles.Library;component/StylesDictionary.xaml"/>
        </ResourceDictionary.MergedDictionaries>
      </ResourceDictionary>
    </Application.Resources>
</Application>

Make sure to get all elements in the complex URI right. There is a complex explanation for this, but I can live without fully understanding the logic behind this. I got this from this article at Code Project:

Make sure your desktop project has a dependency registered to the Styles.Library dll.

Now the application should run as before, but it will use your (empty) resource dictionary library.

Adding Low Level Resources

It is now possible to set up the common low level resources. This includes colours, basic sizing and fonts. The basic idea is that we want to refer to them by name and function and not by the actual value, so if later you want to revise the colour scheme, you only need to change it at one spot.

Set Up Colours

The ColorSchemaDictionary is intended to collect all colours. To give a idea of the syntax, as very simple schema is created, just enough to show how it works. You need to set up colours as brushes. In this example, I only use solid brushes, but it also works for other brush types.

XAML
<!--  Window colors  -->
<SolidColorBrush x:Key="WindowBackground" Color="LightBlue" />
<SolidColorBrush x:Key="WindowBorderBrush" Color="CornflowerBlue" />
<SolidColorBrush x:Key="ControlBackground" Color="LightBlue" />
<SolidColorBrush x:Key="TextBoxBackground" Color="Oldlace" />
<SolidColorBrush x:Key="HeaderBackground" Color="DarkGray" />

<!--  Border colors  -->
<SolidColorBrush x:Key="BorderDefault" Color="DarkBlue" />
<SolidColorBrush x:Key="BorderAlert" Color="OrangeRed" />

<!--  Text colors  -->
<SolidColorBrush x:Key="LabelText" Color="DarkBlue" />
<SolidColorBrush x:Key="DataText" Color="Black" />
<SolidColorBrush x:Key="AlertText" Color="OrangeRed" />

<!--  Button colors  -->
<SolidColorBrush x:Key="ButtonBackground" Color="DarkBlue" />
<SolidColorBrush x:Key="ButtonText" Color="Lavender" />
<SolidColorBrush x:Key="ButtonDisabled" Color="Gray" />
<SolidColorBrush x:Key="ButtonHover" Color="CornflowerBlue" />
<SolidColorBrush x:Key="ButtonPressed" Color="LightBlue" />

If you view this code in Visual Studio, it will show small colour samples. The big advantage is that you have all colours at one place, which makes it easy to review if you have a nice balance.

You should consider naming carefully. Intellisense will work, but if you start typing a B, it will only show everything starting with the character B. Therefore I prefer to mention the control type first in the name and then a descriptive text of what the function of the resource is. This may seem an open door, but I still regret the projects where I did this in a wrong order, e.g., setting things like DefaultWindowBackgroundColor and so on. Then you have a long list of Default to search through.

You can refer to these colours directly from the control where you like to use it:

XAML
<Button Background="{StaticResource ButtonBackground}"
        Foreground="{StaticResource ButtonText}">Test button</Button>

If you put this code in your main window, you will see a window filling blue button, with a Lavender white text. As you see in the code above, this way of using named resources is very cumbersome, so we will do it better. The button still uses the whole window size. This is not what you normally want, so the next step is to define some default dimensions.

Set Up Dimensions

To keep a clear overview, dimensions are separated from colours. The SizeSchemaDictionary should be used. This may look like this:

XAML
<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
                    xmlns:system="clr-namespace:System;assembly=System.Runtime">
 
  <Thickness
    x:Key="MarginDefault"
    Bottom="5"
    Left="5"
    Right="5"
    Top="5" />

  <Thickness
    x:Key="MarginSmall"
    Bottom="3"
    Left="3"
    Right="3"
    Top="3" />

  <Thickness
    x:Key="PaddingDefault"
    Bottom="2"
    Left="2"
    Right="2"
    Top="2" />

  <Thickness
    x:Key="PaddingSmall"
    Bottom="1"
    Left="1"
    Right="1"
    Top="1" />

  <Thickness
    x:Key="ThinBorderWidth"
    Bottom="1"
    Left="1"
    Right="1"
    Top="1" />

  <CornerRadius
    x:Key="CornersDefault"
    BottomLeft="5"
    BottomRight="5"
    TopLeft="5"
    TopRight="5" />

  <!-- Button dimensions -->
  <system:Double x:Key="ButtonDefaultWidth">100</system:Double>
  <system:Double x:Key="ButtonWideWidth">120</system:Double>
  <system:Double x:Key="ButtonDefaultHeight">30</system:Double>
  <system:Double x:Key="TextBoxDefaultHeight">30</system:Double>
</ResourceDictionary>

In this way, your markup is better re-usable, but your xaml specs will grow large and it still is a lot of typing.

One comment. I tend to apply this MarginDefault to every single control in this way. There may be other options, e.g., to apply margin at the right and bottom sides only. I noticed that your markup soon gets ugly if the way you apply margin is not consistent. Then you may need to apply manual fixes, to get controls properly aligned, which may result in more inconsistencies, resulting in broken markup if you change anything. Because I apply the same margin to all controls, everything looks well aligned always. This is combined with standardization of other dimensions as well, using the way of working shown above. Before we apply this one level higher, we still need to learn how to set up fonts.

Setting Up Fonts

For a long time, I could not find a lot of information on how to make re-usable font settings. It is not really straight forward, but this is how you can do it.

You can define a Font Family like this:

XAML
<FontFamily x:Key="FontFamilyDefault">Consolas, Arial</FontFamily> 

In this case, two font families are defined, Arial can be used as a replacement if Consolas is not available. If you want to use, non-standard font, you need to make sure these will be included in the solution or installer somehow.

You can use this with a setter in a style:

XAML
<Setter Property="FontFamily" Value="{DynamicResource FontFamilyDefault}"/>

Defining a font size is a bit more complicated. The problem is that by default, you cannot pass units in the size, e.g., you cannot specify a 12pt font. If you do not specify units, WPF defaults to 1/96 inch. This works, but you need to set sizes considerably larger that you would use in e.g. Word.

I found a solution at StackOverFlow:

You need to create a new class. I use C# here, you can just include this in your code, even if you use other languages normally.

C#
using System;
using System.ComponentModel;
using System.Windows;
using System.Windows.Markup;

namespace Styles.Library
  {
  // Usage: <local:FontSize Size="11pt" x:Key="ElevenPoint"/>
  public class FontSizeExtension : MarkupExtension
    {
    [TypeConverter(typeof(FontSizeConverter))]
    public double Size { get; set; }

    public override object ProvideValue(IServiceProvider serviceProvider)
      {
      return Size;
      }
    }
  }

There is a lot of technology behind this solution, I will not try to explain it. Now you can define the size like this:

XAML
<local:FontSize Size="20pt" x:Key="FontSizeDefault"/>

Visual Studio will set up the "using" statement in the resource dictionary for you normally:

XAML
xmlns:local="clr-namespace:Styles.Library"

This complexity will be hidden in your style definitions:

XAML
<Setter Property="FontFamily" Value="{DynamicResource FontFamilyDefault}" />

Font weight and font style are straight forward:

XAML
<!-- FontWeight -->
 <FontWeight x:Key="FontWeightDefault">Black</FontWeight>
 <FontWeight x:Key="FontWeightTextBlock">Normal</FontWeight>
 <FontWeight x:Key="FontWeightTextBox">Normal</FontWeight>

 <!-- FontStyle -->
 <FontStyle x:Key="FontStyleDefault">Italic</FontStyle>
 <FontStyle x:Key="FontStyleTextBlock">Italic</FontStyle>
 <FontStyle x:Key="FontStyleTextBox">Normal</FontStyle>

Finally, there some styles, like underline, strikethrough that are treated in Word as part of the font settings, but WPF works differently. Here, these attributes are attached to a specific control, e.g., TextBlock or TextBox. The Window control does not support it, so you cannot globally underline all texts.

This is how you can define them as style resources:

XAML
<Style x:Key="TextBlockUnderlined">
    <Setter Property="TextBlock.TextDecorations" Value="Underline" />
  </Style>

  <Style x:Key="TextBoxUnderlined">
    <Setter Property="TextBox.TextDecorations" Value="Underline" />
  </Style>

Also see https://www.manongdao.com/q-204646.html where I found this way to solve the issue. Their usage fits in the general pattern.

Application in Control Styles

We have the basics covered, so we can move on to the next step., defining some styles for controls.

Markup tends to be large and not very readable. To make this better, you can define styles for your controls. Because this tutorial focuses on setting up the way of working, defining complex styles will not be covered.

It is possible to change the default style for each control. Being lazy, I tried to do so, but in a number of cases, you will run into trouble. The reason is that controls may be used in other controls. If you start applying fancy default styles, these styles will also be applied where you really do not want this. Therefore, 99% of the styles I use do have a key and must be applied explicitly. I learned my lesson here …

This article gives some nice examples: https://ikriv.com/dev/wpf/TextStyle/

So, as a rule, always specify x:Key to keep control over the usage of a style.

It helps to make a division in style files. For this demo, four additional style dictionaries will be created and wired up:

  • WindowDictionary for Window styles
  • ButtonDictionary for buttons
  • TextBlockDictionary for TextBlocks
  • TextBoxDictionary for TextBoxes

Set Up WindowDictionary

This example is simple, so a good starting point. Create a resource dictionary named WindowDictionary which contains this code:

XAML
<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">

  <!--  Window style  -->

  <Style x:Key="WindowDefault" TargetType="Window">
    <Setter Property="Background" Value="{DynamicResource WindowBackground}" />
  </Style>
</ResourceDictionary>

This defines a Style for windows, that will set the background colour. In the demo application, I also set the fonts, but for simplicity I leave this out here.

An important thing to note: If you create the resource dictionary inside the project where it is used, you can use StaticResource as resource type. For dictionaries created in a separate library project, always use DynamicResource as shown in the example. Otherwise your resource will not be recognized. It took me quite some time to find out you need to do this, so be warned.

Now you must make sure the resource is known the library interface, so adapt StylesDictionary:

XAML
<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
   
  <ResourceDictionary.MergedDictionaries>
    <!-- Basic markup -->
    <ResourceDictionary Source="ColorSchemaDictionary.xaml" />
    <ResourceDictionary Source="SizeSchemaDictionary.xaml" />
    <ResourceDictionary Source="FontDictionary.xaml" />
    <ResourceDictionary Source="WindowDictionary.xaml" />
    <ResourceDictionary Source="ButtonDictionary.xaml" />
    <ResourceDictionary Source="TextBlockDictionary.xaml" />
    <ResourceDictionary Source="TextBoxDictionary.xaml" />
  </ResourceDictionary.MergedDictionaries>
</ResourceDictionary>

And finally, apply the style to the window (here, you can use a static resource):

XAML
<Window x:Class="StyleDemo.DesktopUI.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        mc:Ignorable="d"
        Style="{StaticResource WindowDefault}"
        Title="MainWindow" Height="450" Width="800">

    <Grid>
        <Button Background="{StaticResource ButtonBackground}"
                Foreground="{StaticResource ButtonText}"
                Width="{StaticResource ButtonDefaultWidth}"
                Height="{StaticResource ButtonDefaultHeight}"
                Margin="{StaticResource MarginDefault}"
                Padding="{StaticResource PaddingDefault}">Test button</Button>
    </Grid>
</Window>

The result should be a nice blue screen with a dark blue button in the centre.

When creating this style, I would have liked to make default for WindowStartupLocation as well. This will not work, because it is not a XAML dependency property. At stackoverflow, you find a workaround. I guess it is also possible to derive your own window class and fix this there.

This allows you to make all windows look similar and you may change the background colour easily.

Examples for Other Controls

To show some slightly more complex examples, I added three styles, for a TextBlock, a TextBox and a Button.

The TextBlock is straight forward:

XAML
<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
 
  <Style x:Key="TextBlockDefault" TargetType="{x:Type TextBlock}">
    <Setter Property="Foreground" Value="{DynamicResource LabelText}" />
    <Setter Property="Background" Value="{DynamicResource ControlBackground}" />
    <Setter Property="Margin" Value="{DynamicResource MarginDefault}" />
    <Setter Property="HorizontalAlignment" Value="Stretch" />
    <Setter Property="VerticalAlignment" Value="Center" />
    <Setter Property="FontSize" Value="{DynamicResource FontSizeTextBlock}" />
    <Setter Property="FontFamily" Value="{DynamicResource FontFamilyTextBlock}" />
    <Setter Property="FontWeight" Value="{DynamicResource FontWeightTextBlock}" />
  </Style>

</ResourceDictionary>

You can define other variants in the same or in separate resource dictionaries.

For the TextBox, I adapted the default TextBox (the x:Key attribute is not defined). In this case, this works. Not shown in the demo, but I created some variants like a read-only textbox and a multiline textbox. It depends on your taste and needs how you want to do this.

XAML
<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
                    xmlns:local="clr-namespace:Styles.Library">

  <!--  Textbox  -->

  <Style TargetType="{x:Type TextBox}">
    <Setter Property="FontSize" Value="{DynamicResource FontSizeTextBox}" />
    <Setter Property="FontFamily" Value="{DynamicResource FontFamilyTextBox}" />
    <Setter Property="FontWeight" Value="{DynamicResource FontWeightTextBox}" />
    <Setter Property="FontStyle" Value="{DynamicResource FontStyleTextBox}" />

    <Setter Property="Foreground" Value="{DynamicResource DataText}" />
    <Setter Property="Background" Value="{DynamicResource TextBoxBackground}" />
    <Setter Property="Margin" Value="{DynamicResource MarginDefault}" />
    <Setter Property="Padding" Value="{DynamicResource PaddingDefault}" />
    <Setter Property="Height" Value="{DynamicResource TextBoxDefaultHeight}" />
    <Setter Property="HorizontalAlignment" Value="Stretch" />
    <Setter Property="TextAlignment" Value="Left" />
    <Setter Property="VerticalContentAlignment" Value="Center" />
  </Style>
</ResourceDictionary>

Buttons are far more complicated, if you want to use markup variants for a mouse over, pressed or disabled state. I show the example here, to give you a starting point.

XAML
<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
                    xmlns:local="clr-namespace:Styles.Library">
 
  <!--  Standard button layout  -->

  <Style x:Key="ButtonDefault" TargetType="{x:Type Button}">
    <Setter Property="HorizontalContentAlignment" Value="Center" />
    <Setter Property="VerticalContentAlignment" Value="Center" />
    <Setter Property="Margin" Value="{DynamicResource MarginDefault}" />
    <Setter Property="Width" Value="{DynamicResource ButtonDefaultWidth}" />
    <Setter Property="Height" Value="{DynamicResource ButtonDefaultHeight}" />
    <Setter Property="Background" Value="{DynamicResource ButtonBackground}"/>
    <Setter Property="Foreground" Value="{DynamicResource ButtonText}"/>
    <Setter Property="Template">
      <Setter.Value>
        <ControlTemplate TargetType="{x:Type Button}">
          <Grid x:Name="grid">
            <Border
              x:Name="border"
              Background="{DynamicResource ButtonBackground}"
              BorderBrush="{DynamicResource LabelText}"
              Padding="{DynamicResource PaddingDefault}"
              BorderThickness="{DynamicResource ThinBorderWidth}">
              <ContentPresenter
                HorizontalAlignment="Center"
                VerticalAlignment="Center"
                TextElement.FontWeight="Bold" />
            </Border>
          </Grid>
          <ControlTemplate.Triggers>
            <Trigger Property="IsPressed" Value="True">
              <Setter TargetName="border"
                      Property="Background"
                      Value="{DynamicResource ButtonPressed}" />
            </Trigger>
            <Trigger Property="IsMouseOver" Value="True">
              <Setter TargetName="border"
                      Property="Background"
                      Value="{DynamicResource ButtonHover}" />
            </Trigger>
            <Trigger Property="IsEnabled" Value="False">
              <Setter TargetName="border"
                      Property="Background"
                      Value="{DynamicResource ButtonDisabled}" />
            </Trigger>
          </ControlTemplate.Triggers>
        </ControlTemplate>
      </Setter.Value>
    </Setter>
 </Style>
 
</ResourceDictionary>

This allows you to display a disabled button using a grey background:

XML
<Button Style="{StaticResource ButtonDefault}" IsEnabled="False">
Disabled button
</Button>

It is OK if you do not fully understand this example, but you can walk through the code and find some more background on customizing buttons as you need it.

The fonts for the buttons are inherited from the font settings at the Window level. You may or may not want that, depending on the level of control you need.

Final Remarks

In this article, I present a way of working I discovered with trial and error during a long period of time, with a lot of help from generous developers who contributed with their solutions and answers to questions. The solution is not intended as a copy paste solution that solves all your markup problems. It depends on your specific needs how you setup the details. My choice is to do it relatively low level, but with extensive re-use of the low level components. You may choose to use only one font for a number of controls. This is less work, but if you want to change the design, this may cause more work.

I am looking forward to hearing about better solutions. In many aspects, I am a beginner, but this works for me right now and I hope it helps you to create something that works for you.

History

  • Version 1.0: Initial version of this article
  • Version 1.1: Small update, improved text to stress the importance to  use DynamicResource

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Retired
Netherlands Netherlands
Got an MS degree in Electrical Engineering a long time ago (in the time before Computer Science was invented as something you could study). I have been involved somehow in software development since I created my first Algol 60 program, using punched cards and an IBM360 machine. Now I develop C#/WPF desktop applications, partly for fun, partly to help other people.

Comments and Discussions

 
QuestionLink to github Pin
Terppe4-Apr-20 4:54
Terppe4-Apr-20 4:54 
AnswerRe: Link to github Pin
Rudolf Jan6-Apr-20 2:31
Rudolf Jan6-Apr-20 2:31 
QuestionStaticResource vs DynamicResource Pin
carloscs3-Apr-20 1:51
carloscs3-Apr-20 1:51 
"If you create the resource dictionary inside the project where it is used, you can use StaticResource as resource type. For dictionaries created in a separate library project, always use DynamicResource as shown in the example."

Could you please expand a little on this (reasons, docs/links anywhere)?

In my app I create only one resource dictionary in App.xaml (merging dictionaries from the styles library plus one or two in other libraries) and use the resources on any of the 30 other libraries using StaticResource with no problems.

I'm just curious to know why/wen this applies.

Edit:
And you should make this note more prominent, right now it's a bit lost in the middle of the text.
AnswerRe: StaticResource vs DynamicResource Pin
Rudolf Jan6-Apr-20 2:36
Rudolf Jan6-Apr-20 2:36 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.