Various Styling Options

There are many ways you can set CSS styles in this editor.

1. Setting the BodyStyle Property.

2. Setting the BodyCSSClassName Property

3. Setting DocumentCSSFilePath Property

4. Setting HeaderStyleContent Property.

5. Manually inserting Style element block either inside the Head element or inside the Body Element.

1. BodyStyle property has rich design time support for Style Editor, but you can ignore the Editor Dialog and set your own CSS style string. This BodyStyle editing is available both for Developer at design time or run time AND the user from run time.

Developer's use case

Design Time:

BodyStyle property design time

Run Time:

C#

private void Button_Click(object sender, System.Windows.RoutedEventArgs e)
{
    wpfHtmlEditor1.BodyStyle = "color: blue; font-size: 15px";
}

VB

Private Sub Button_Click(sender As Object, e As System.Windows.RoutedEventArgs)
 wpfHtmlEditor1.BodyStyle = "color: blue; font-size: 15px"
End Sub

Naturally, you can set your CSS string from Design time BodyStyle property editor too.

User's use case

StyleBuilder

If you do not want to allow the user to set BodyStyle, you can hide the CSS Toolbar button using following code within your Form's Load event.

C#

private void Window1_OnLoaded(object sender, RoutedEventArgs e)
{
    wpfHtmlEditor1.ToolbarItemOverrider.ToolbarItems.BodyStyle.Visibility = Visibility.Collapsed;
}

VB

Private Sub Window1_OnLoaded(sender As Object, e As RoutedEventArgs)
 wpfHtmlEditor1.ToolbarItemOverrider.ToolbarItems.BodyStyle.Visibility = Visibility.Collapsed
End Sub

2. BodyCSSClassName is a powerful way of imposing CSS on your editing document. If you already defined your CSS style in an external CSS file, then, you can simply set the class name to this property. This feature opens lots of possibilities like, you can set a dedicated class name for design time editing (WYSIWYG) and simply not providing the CSS file in your publishing site, you can get rid of those design time CSS.

3. If you want to get or set an external CSS file for the document, the property you are looking for is named "DocumentCSSFilePath". You can set a valid file path to any CSS file. It is more practical that you will set this property from code, within your Window's Loaded event.

4. HeaderStyleContent property allows you to set CSS directly within the <head> element of the html document. In order to support this feature, an id attribute is used for the style element block. By default, this id is 'page_style'. But you can change that value too by setting property HeaderStyleContentElementID.

HeaderStyleContent properties

5. You can always insert your custom Style block manually using the Editor's Content Service as shown here:

C#

private void Window1_OnLoaded(object sender, RoutedEventArgs e)
{
    wpfHtmlEditor1.Content.InsertHtmlBetweenHead("<style>p { color: blue; }</style>");
}
VB
Private Sub Window1_OnLoaded(sender As Object, e As RoutedEventArgs)
 wpfHtmlEditor1.Content.InsertHtmlBetweenHead("<style>p { color: blue; }</style>")
End Sub

And that will result :

InsertHtmlBetweenHead() result

Appendix : Here is the set of screenshots for all pages in the Style Builder Dialogue:

CSS:

StyleBuilder Font



Font Picker:

StyleBuilder Font picker



Background Style:

StyleBuilder Background



Text Style:

StyleBuilder Text



Position Style:

StyleBuilder Position



Layout Style:

StyleBuilder Layout



Edges Style:

StyleBuilder Edges



List Style:

StyleBuilder Lists



Other Style:

StyleBuilder Other




Last updated on 29 May 2015, Friday, 12:03:30 PM
If you have any questions or concerns about this tutorial, Please feel free to share your comment.