# Document Themes
Document themes let you specify colors, fonts, and a variety of graphic effects in a document and affect the look and feel of the whole document. Each theme contains a color scheme and a font scheme and is represented by the `DocumentTheme` class. You can modify the theme through the `Theme` property of [RadFlowDocument](https://www.telerik.com/document-processing-libraries/documentation/libraries/radwordsprocessing/model/radflowdocument). A document theme contains two parts—a color scheme responsible for the colors, and a font scheme responsible for the fonts.
* [Color Schemes](https://www.telerik.com/document-processing-libraries/documentation/libraries/radwordsprocessing/concepts/document-themes#color-schemes)
* [Font Schemes](https://www.telerik.com/document-processing-libraries/documentation/libraries/radwordsprocessing/concepts/document-themes#font-schemes)
* [Document Themes](https://www.telerik.com/document-processing-libraries/documentation/libraries/radwordsprocessing/concepts/document-themes#creating-document-themes)
* [Getting Actual Values](https://www.telerik.com/document-processing-libraries/documentation/libraries/radwordsprocessing/concepts/document-themes#getting-actual-values)
## Color Schemes
A color scheme has a unique name and contains a number of predefined colors. Its representation in the `RadFlowDocument` model is the `ThemeColorScheme` class. A scheme defines twelve colors and each of these is assigned a sole `ThemeColorType`. The following list contains all `ThemeColorType` values:
* background1
* text1
* background2
* text2
* accent1
* accent2
* accent3
* accent4
* accent5
* accent6
* hyperlink
* followed hyperlink
The twelve color types listed previously are used for creating `ThemableColor` objects. They determine the color of the scheme that appears as the actual color of the `ThemableColor` instance. As you change the theme or the color scheme, the actual color of the `ThemableColor` object changes as well. For example, if you set the fill of a cell to be a `ThemableColor`, applying a new theme or another scheme also affects the solid fill.
The following example demonstrates how to create a `ThemeColorScheme` object. Note that the example passes a name and twelve colors to the constructor. Every color has a comment next to it, so you can see its corresponding `ThemeColorType`.
**Example 1: Create a custom ThemeColorScheme with explicit colors for all theme slots**
```C#
ThemeColorScheme colorScheme = new ThemeColorScheme(
"Mine",
Colors.Black, // background 1
Colors.Blue, // text 1
Colors.Brown, // background 2
Colors.Cyan, // text 2
Colors.DarkGray, // accent 1
Colors.Gray, // accent 2
Colors.Green, // accent 3
Colors.LightGray, // accent 4
Colors.Magenta, // accent 5
Colors.Orange, // accent 6
Colors.Purple, // hyperlink
Colors.Red); // followedHyperlink
```
There are several ways to create a `ThemableColor` object:
* Passing two parameters to the constructor—*ThemeColorType* and *double*.
* `ThemeColorType` is an enum which has twelve possible values (the color types listed previously).
* The second parameter is of type `double` and must be between -1 and 1. It represents the tint and shade to be applied to the selected color.
* Passing *ThemeColorType* and *ColorShadeType*.
* `ThemeColorType` is the same as in the previously mentioned constructor.
To create colors that depend on the current document theme, use `ThemableColor` objects.
**Example 2: Create a ThemableColor bound to the Accent1 theme color**
```C#
ThemableColor themableColor = new ThemableColor(ThemeColorType.Accent1);
```
## Font Schemes
A font scheme is represented by the `ThemeFontScheme` class. Every font scheme consists of a name and a number of predefined font families. Each font family corresponds to one of two font types:
* Major
* Minor
The code in the following example illustrates how to create a `ThemeFontScheme` object. A name and two font family names are passed to the font scheme constructor. The former font family name corresponds to the Major `ThemeFontType` and the latter to the Minor.
**Example 3: Create a ThemeFontScheme with custom major and minor fonts**
```C#
ThemeFontScheme fontScheme = new ThemeFontScheme(
"Mine",
"Times New Roman", // Major
"Arial"); // Minor
```
To use the document theme fonts, you need to use `ThemableFontFamily` objects. There are several ways you can create one:
* Passing a `ThemeFontType` object as a constructor parameter—this binds the object to the currently selected document theme.
* Passing a `FontFamily` object or a string representing a FontFamily name—the result is a static FontFamily that does not change when the document theme changes.
When you need to create a font that depends on the current document theme, use `ThemableFontFamily` objects.
**Example 4: Create a ThemableFontFamily that uses the major theme font**
```C#
ThemableFontFamily themableFont = new ThemableFontFamily(ThemeFontType.Major);
```
## Document Themes
Now that you have a color and a font scheme, you can create a new `DocumentTheme`. Specify a name and pass the already created color and font schemes.
**Example 5: Combine the custom color and font schemes into a DocumentTheme**
```C#
DocumentTheme theme = new DocumentTheme("Mine", colorScheme, fontScheme);
```
There are a number of predefined color and font schemes. You can find them in a static class called [PredefinedThemeSchemes](https://docs.telerik.com/devtools/document-processing/api/Telerik.Windows.Documents.Spreadsheet.Theming.PredefinedThemeSchemes.html). The class exposes the properties `ColorSchemes` and `FontSchemes` that hold all predefined schemes.
**Example 6: Create a DocumentTheme from predefined color and font schemes**
```C#
DocumentTheme theme1 = new DocumentTheme("From Predefined schemes", PredefinedThemeSchemes.ColorSchemes[0], PredefinedThemeSchemes.FontSchemes[5]);
```
Changing the current document theme requires setting a single property.
**Example 7: Assign the custom theme to a RadFlowDocument**
```C#
RadFlowDocument document = new RadFlowDocument();
document.Theme = theme;
```
## Predefined ThemeColorSchemes
The table includes all 42 predefined theme color schemes with their corresponding color values for each color category (Background 1, Text 1, Background 2, Text 2, Accent 1-6, Hyperlink, and Followed Hyperlink).
| Theme Name | Background 1 | Text 1 | Background 2 | Text 2 | Accent 1 | Accent 2 | Accent 3 | Accent 4 | Accent 5 | Accent 6 | Hyperlink | Followed Hyperlink |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Office | `#FFFFFF` | `#000000` | `#E7E6E6` | `#44546A` | `#4472C4` | `#ED7D31` | `#A5A5A5` | `#FFC000` | `#5B9BD5` | `#70AD47` | `#0563C1` | `#954F72` |
| Office 2007 - 2010 | `#FFFFFF` | `#000000` | `#EEECE1` | `#1F497D` | `#4F81BD` | `#C0504D` | `#9BBB59` | `#8064A2` | `#4BACC6` | `#F79646` | `#0000FF` | `#800080` |
| Grayscale | `#FFFFFF` | `#000000` | `#F8F8F8` | `#000000` | `#DDDDDD` | `#B2B2B2` | `#969696` | `#808080` | `#5F5F5F` | `#4D4D4D` | `#5F5F5F` | `#919191` |
| Adjacency | `#FFFFFF` | `#2F2B20` | `#DFDCB7` | `#675E47` | `#A9A57C` | `#9CBEBD` | `#D2CB6C` | `#95A39D` | `#C89F5D` | `#B1A089` | `#D25814` | `#849A0A` |
| Angels | `#FFFFFF` | `#000000` | `#CDD7D9` | `#434342` | `#797B7E` | `#F96A1B` | `#08A1D9` | `#7C984A` | `#C2AD8D` | `#506E94` | `#5F5F5F` | `#969696` |
| Apex | `#FFFFFF` | `#000000` | `#C9C2D1` | `#69676D` | `#CEB966` | `#9CB084` | `#6BB1C9` | `#6585CF` | `#7E6BC9` | `#A379BB` | `#410082` | `#932968` |
| Apothecary | `#FFFFFF` | `#000000` | `#ECEDD1` | `#564B3C` | `#93A299` | `#CF543F` | `#B5AE53` | `#848058` | `#E8B54D` | `#786C71` | `#CCCC00` | `#B2B2B2` |
| Aspect | `#FFFFFF` | `#000000` | `#E3DED1` | `#323232` | `#F07F09` | `#9F2936` | `#1B587C` | `#4E8542` | `#604878` | `#C19859` | `#6B9F25` | `#B26B02` |
| Austin | `#FFFFFF` | `#000000` | `#CAF278` | `#3E3D2D` | `#94C600` | `#71685A` | `#FF6700` | `#909465` | `#956B43` | `#FEA022` | `#E68200` | `#FFA94A` |
| Black Tie | `#FFFFFF` | `#000000` | `#E3DCCF` | `#46464A` | `#6F6F74` | `#A7B789` | `#BEAE98` | `#92A9B9` | `#9C8265` | `#8D6974` | `#67AABF` | `#B1B5AB` |
| Civic | `#FFFFFF` | `#000000` | `#C5D1D7` | `#646B86` | `#D16349` | `#CCB400` | `#8CADAE` | `#8C7B70` | `#8FB08C` | `#D19049` | `#00A3D6` | `#694F07` |
| Clarity | `#FFFFFF` | `#292934` | `#F3F2DC` | `#D2533C` | `#93A299` | `#AD8F67` | `#726056` | `#4C5A6A` | `#808DA0` | `#79463D` | `#0000FF` | `#800080` |
| Composite | `#FFFFFF` | `#000000` | `#E7ECED` | `#5B6973` | `#98C723` | `#59B0B9` | `#DEAE00` | `#B77BB4` | `#E0773C` | `#A98D63` | `#26CBEC` | `#598C8C` |
| Concourse | `#FFFFFF` | `#000000` | `#DEF5FA` | `#464646` | `#2DA2BF` | `#DA1F28` | `#EB641B` | `#39639D` | `#474B78` | `#7D3C4A` | `#FF8119` | `#44B9E8` |
| Couture | `#FFFFFF` | `#000000` | `#D0CCB9` | `#37302A` | `#9E8E5C` | `#A09781` | `#85776D` | `#AEAFA9` | `#8D878B` | `#6B6149` | `#B6A272` | `#8A784F` |
| Elemental | `#FFFFFF` | `#000000` | `#ACCBF9` | `#242852` | `#629DD1` | `#297FD5` | `#7F8FA9` | `#4A66AC` | `#5AA2AE` | `#9D90A0` | `#9454C3` | `#3EBBF0` |
| Equity | `#FFFFFF` | `#000000` | `#E9E5DC` | `#696464` | `#D34817` | `#9B2D1F` | `#A28E6A` | `#956251` | `#918485` | `#855D5D` | `#CC9900` | `#96A9A9` |
| Essential | `#FFFFFF` | `#000000` | `#C8C8B1` | `#D1282E` | `#7A7A7A` | `#F5C501` | `#526DB0` | `#989AAC` | `#DC5924` | `#B4B392` | `#CC9900` | `#969696` |
| Executive | `#FFFFFF` | `#000000` | `#E4E9EF` | `#2F5897` | `#6076B4` | `#9C5252` | `#E68422` | `#846648` | `#63891F` | `#758085` | `#3399FF` | `#B2B2B2` |
| Flow | `#FFFFFF` | `#000000` | `#DBF5F9` | `#04617B` | `#0F6FC6` | `#009DD9` | `#0BD0D9` | `#10CF9B` | `#7CCA62` | `#A5C249` | `#F49100` | `#85DFD0` |
| Foundry | `#FFFFFF` | `#000000` | `#EAEBDE` | `#676A55` | `#72A376` | `#B0CCB0` | `#A8CDD7` | `#C0BEAF` | `#CEC597` | `#E8B7B7` | `#DB5353` | `#903638` |
| Grid | `#FFFFFF` | `#000000` | `#CCD1B9` | `#534949` | `#C66951` | `#BF974D` | `#928B70` | `#87706B` | `#94734E` | `#6F777D` | `#CC9900` | `#C0C0C0` |
| Hardcover | `#FFFFFF` | `#000000` | `#ECE9C6` | `#895D1D` | `#873624` | `#D6862D` | `#D0BE40` | `#877F6C` | `#972109` | `#AEB795` | `#CC9900` | `#B2B2B2` |
| Horizon | `#FFFFFF` | `#000000` | `#DC9E1F` | `#1F2123` | `#7E97AD` | `#CC8E60` | `#7A6A60` | `#B4936D` | `#67787B` | `#9D936F` | `#646464` | `#969696` |
| Median | `#FFFFFF` | `#000000` | `#EBDDC3` | `#775F55` | `#94B6D2` | `#DD8047` | `#A5AB81` | `#D8B25C` | `#7BA79D` | `#968C8C` | `#F7B615` | `#704404` |
| Metro | `#FFFFFF` | `#000000` | `#D6ECFF` | `#4E5B6F` | `#7FD13B` | `#EA157A` | `#FEB80A` | `#00ADDC` | `#738AC8` | `#1AB39F` | `#EB8803` | `#5F7791` |
| Module | `#FFFFFF` | `#000000` | `#D4D4D6` | `#5A6378` | `#F0AD00` | `#60B5CC` | `#E66C7D` | `#6BB76D` | `#E88651` | `#C64847` | `#168BBA` | `#680000` |
| Newsprint | `#FFFFFF` | `#000000` | `#DEDEE0` | `#303030` | `#AD0101` | `#726056` | `#AC956E` | `#808DA9` | `#424E5B` | `#730E00` | `#D26900` | `#D89243` |
| Opulent | `#FFFFFF` | `#000000` | `#F4E7ED` | `#B13F9A` | `#B83D68` | `#AC66BB` | `#DE6C36` | `#F9B639` | `#CF6DA4` | `#FA8D3D` | `#FFDE66` | `#D490C5` |
| Oriel | `#FFFFFF` | `#000000` | `#FFF39D` | `#575F6D` | `#FE8637` | `#7598D9` | `#B32C16` | `#F5CD2D` | `#AEBAD5` | `#777C84` | `#D2611C` | `#3B435B` |
| Origin | `#FFFFFF` | `#000000` | `#DDE9EC` | `#464653` | `#727CA3` | `#9FB8CD` | `#D2DA7A` | `#FADA7A` | `#B88472` | `#8E736A` | `#B292CA` | `#6B5680` |
| Paper | `#FFFFFF` | `#000000` | `#FEFAC9` | `#444D26` | `#A5B592` | `#F3A447` | `#E7BC29` | `#D092A7` | `#9C85C0` | `#809EC2` | `#8E58B6` | `#7F6F6F` |
| Perspective | `#FFFFFF` | `#000000` | `#FF8600` | `#283138` | `#838D9B` | `#D2610C` | `#80716A` | `#94147C` | `#5D5AD2` | `#6F6C7D` | `#6187E3` | `#7B8EB8` |
| Pushpin | `#FFFFFF` | `#000000` | `#CCDDEA` | `#465E9C` | `#FDA023` | `#AA2B1E` | `#71685C` | `#64A73B` | `#EB5605` | `#B9CA1A` | `#D83E2C` | `#ED7D27` |
| Slipstream | `#FFFFFF` | `#000000` | `#B4DCFA` | `#212745` | `#4E67C8` | `#5ECCF3` | `#A7EA52` | `#5DCEAF` | `#FF8021` | `#F14124` | `#56C7AA` | `#59A8D1` |
| Solstice | `#FFFFFF` | `#000000` | `#E7DEC9` | `#4F271C` | `#3891A7` | `#FEB80A` | `#C32D2E` | `#84AA33` | `#964305` | `#475A8D` | `#8DC765` | `#AA8A14` |
| Technic | `#FFFFFF` | `#000000` | `#D4D2D0` | `#3B3B3B` | `#6EA0B0` | `#CCAF0A` | `#8D89A4` | `#748560` | `#9E9273` | `#7E848D` | `#00C8C3` | `#A116E0` |
| Thatch | `#FFFFFF` | `#000000` | `#DFE6D0` | `#1D3641` | `#759AA5` | `#CFC60D` | `#99987F` | `#90AC97` | `#FFAD1C` | `#B9AB6F` | `#66AACD` | `#809DB3` |
| Trek | `#FFFFFF` | `#000000` | `#FBEEC9` | `#4E3B30` | `#F0A22E` | `#A5644E` | `#B58B80` | `#C3986D` | `#A19574` | `#C17529` | `#AD1F1F` | `#FFC42F` |
| Urban | `#FFFFFF` | `#000000` | `#DEDEDE` | `#424456` | `#53548A` | `#438086` | `#A04DA3` | `#C4652D` | `#8B5D3D` | `#5C92B5` | `#67AFBD` | `#C2A874` |
| Verve | `#FFFFFF` | `#000000` | `#D2D2D2` | `#666666` | `#FF388C` | `#E40059` | `#9C007F` | `#68007F` | `#005BD3` | `#00349E` | `#17BBFD` | `#FF79C2` |
| Waveform | `#FFFFFF` | `#000000` | `#C6E7FC` | `#073E87` | `#31B6FD` | `#4584D3` | `#5BD078` | `#A5D028` | `#F5C040` | `#05E0DB` | `#0080FF` | `#5EAEFF` |
## Predefined ThemeFontSchemes
RadWordsProcessing offers a set of predefined ThemeFontSchemes listed in the table below:
| Theme Name | Major Font | Minor Font |
| ------------------ | ---------------------- | ---------------------- |
| Office | Calibri Light | Calibri |
| Office 2007 - 2010 | Cambria | Calibri |
| Office 2 | Calibri | Cambria |
| Office Classic | Arial | Times New Roman |
| Office Classic 2 | Arial | Arial |
| Adjacency | Cambria | Calibri |
| Angels | Franklin Gothic Medium | Franklin Gothic Book |
| Apex | Lucida Sans | Book Antiqua |
| Apothecary | Book Antiqua | Century Gothic |
| Aspect | Verdana | Verdana |
| Austin | Century Gothic | Century Gothic |
| Black Tie | Garamond | Garamond |
| Civic | Georgia | Georgia |
| Clarity | Arial | Arial |
| Composite | Calibri | Calibri |
| Concourse | Lucida Sans Unicode | Lucida Sans Unicode |
| Couture | Garamond | Garamond |
| Elemental | Palatino Linotype | Palatino Linotype |
| Equity | Franklin Gothic Book | Perpetua |
| Essential | Arial Black | Arial |
| Executive | Century Gothic | Palatino Linotype |
| Flow | Calibri | Constantia |
| Foundry | Rockwell | Rockwell |
| Grid | Franklin Gothic Medium | Franklin Gothic Medium |
| Hardcover | Book Antiqua | Book Antiqua |
| Horizon | Arial Narrow | Arial Narrow |
| Median | Tw Cen MT | Tw Cen MT |
| Metro | Consolas | Corbel |
| Module | Corbel | Corbel |
| Newsprint | Impact | Times New Roman |
| Opulent | Trebuchet MS | Trebuchet MS |
| Oriel | Century Schoolbook | Century Schoolbook |
| Origin | Bookman Old Style | Gill Sans MT |
| Paper | Constantia | Constantia |
| Perspective | Arial | Arial |
| Pushpin | Constantia | Franklin Gothic Book |
| Slipstream | Trebuchet MS | Trebuchet MS |
| Solstice | Gill Sans MT | Gill Sans MT |
| Technic | Franklin Gothic Book | Arial |
| Thatch | Tw Cen MT | Tw Cen MT |
| Trek | Franklin Gothic Medium | Franklin Gothic Book |
| Urban | Trebuchet MS | Georgia |
| Verve | Century Gothic | Century Gothic |
| Waveform | Candara | Candara |
## Getting Actual Values
To get the actual value from `ThemableColor` or `ThemableFontFamily`, call the `GetActualValue()` method on the corresponding object.
**Example 8: Resolve the actual color value from a ThemableColor and theme**
```C#
Color actualColor = themableColor.GetActualValue(theme);
//The actual color is the same as Accent1 color of the colorScheme.
```
**Example 9: Resolve the actual font family from a ThemableFontFamily and theme**
```C#
var actualFont = themableFont.GetActualValue(theme);
//The actualFont is the same as the Major font of the fontScheme.
```
## See Also
* [RadFlowDocument](https://www.telerik.com/document-processing-libraries/documentation/libraries/radwordsprocessing/model/radflowdocument)
* [Document Styles](https://www.telerik.com/document-processing-libraries/documentation/libraries/radwordsprocessing/concepts/styles)