Skip to main content

Binding a HTML-formatted string to a WPF WebBrowser control

Sometimes there is a need to display a HTML formatted string in a WPF application. There are a couple of ways to do this, but the most stright forward is to use a WebBrowser control and the NavigateToString method.

This approach has one big flaw, you cannot use binding to a string out of the box, but I found a great solution through Stack Overflow which adds a bindable property to the  WebBrowser control using  NavigateToString.

The following class is all that is needed to add that behavior. A new depencency property named Html is introduced to the  WebBrowser and the proper change action is performed in the OnHtmlChanged method.

public class BrowserBehavior
{
    public static readonly DependencyProperty HtmlProperty = DependencyProperty.RegisterAttached(
        "Html", typeof(string), typeof(BrowserBehavior), new FrameworkPropertyMetadata(OnHtmlChanged));

    [AttachedPropertyBrowsableForType(typeof(WebBrowser))]
    public static string GetHtml(WebBrowser browser)
    {
        return (string)browser.GetValue(HtmlProperty);
    }

    public static void SetHtml(WebBrowser browser, string value)
    {
        browser.SetValue(HtmlProperty, value);
    }

    static void OnHtmlChanged(DependencyObject dependencyObject, DependencyPropertyChangedEventArgs e)
    {
        var browser = dependencyObject as WebBrowser;
        if (browser != null)
        {
            browser.NavigateToString(e.NewValue);
        }
    }
}

To bind this property the XAML looks like this:
<WebBrowser local:BrowserBehavior.Html="{Binding Path=HtmlText}"></WebBrowser>

Since we are printing some swedish characters the encoding got a little bit funky. This is nothing that the  WebBrowser control itself affects, but it has to be set with an encoding meta tag in the HTML. So simply add the following meta tag to the head section of the HTML to be shown in the browser control:
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8" />

Another thing that does not seem to be able to affect on the  WebBrowser control is the context menu. The default context menu is the same as you would get in an Internet Explorer window. When using the  NavigateToString method to add the content the navigation in the browser control will not work. Hence we would like to hide the context menu. The easiest way to do so is with a litte javascript in the rendered HTML:
<body oncontextmenu="return false;">

By adding these little hacks we have an easy way to show HTML content in a bindable fashion. Sure there are still some caveats to this solution, for instance an F5 keystroke will refresh the browser window. But we cannot use WebBrowserShortcutsEnabled since we want the users to be able to copy text from the browser using the Ctrl-C shortcut.

Comments

  1. Does not make sense if you are reading it and you want start from scratch.
    Does not show what components have to be implemented.
    Actually , looking for solution how to make some kind of html viewer that points to html file make works ( of course I can read the html file to string variable )
    For instance " browser.NavigateToString(e.NewValue);"
    I tried browser.NavigateToString((string)e.NewValue);

    ReplyDelete

Post a Comment

Popular posts from this blog

LEAP Sweden - Identity & Access Management

Today was the third day of the Swedish Lead Enterprise Architect Program at Microsoft in Kista. It has been a day filled with sessions on security and identity with a kind of unavoidable focus on federated identities in the cloud. Overall it has been an awesome day with seminars from Henrik Nilsson , Barry O'Reilly and Sergio Molero among others. A lot of Microsoft technologies was mentioned, Forefront Identity Manager , Active Directory Federation Services 2.0 , Forefront Unified Access Gateway , Direct Access ,  Windows Identity Framework and of course  Azure Access Control Service . Microsoft really has a great suite of applications regarding Identity & Access Management. I just wish there was a project or two where I could utilize all of these amazing technologies. I have had a plan to add a login feature to the Cornball using federated identities, so that might happen in the near future. Besides, Björn Eriksen provided a tip for all of us thursty for e...

The Cornball goes to Brunch with Chaplin

Lately I've been working pretty hard on different projects but not really stumbling upon anything blogworthy. The most recent project is quite interesting though, a single page, touch friendly, web application using the latest and greatest technologies. We've ended up with using Brunch with Chaplin , which is a very neat way of setting up a Backbone based single page web project with Brunch and Chaplin . Aside from this, I have my own little project that has lived on for almost 15 years already, The Cornball . From being a plain Windows application written i C an Win32 API, it has been ported to .NET using WPF, and is currently a Silverlight application hosted on Windows Azure. I could not find a better time to reanimate this project and create a new web based version, touch friendly, super optimized, awesome in any way. So I did... So please follow my journey at Github . It's going to take a while, I assure you, but I already have some ground work done. Meanwhile,...

Using ASP.NET MVC with MEF

I wrote this post almost a year ago, but never published it for some reason. Anyway, here is a little MVC/MEF magic. By default a controller in MVC must have a parameterless constructor. When using MEF a good practice is to inject the services via constructor parameters. These two in combination obviously creates an issue where the following scenario will not work out of the box, since there is no parameterless constructor for  MVC  to use. Note that the PartCreationPolicy is set to NonShared since a new controller have to be initialized for each request. [Export] [PartCreationPolicy(CreationPolicy.NonShared)] public class HomeController : Controller {     private readonly IServiceClient _service;     [ImportingConstructor]     public HomeController(IServiceClient service)     {         _service = service;     }     public ActionResult Index()     {         ...