Click here to Skip to main content
14,218,418 members

WPF HTML Supported TextBlock

Rate this:
4.36 (9 votes)
Please Sign up or sign in to vote.
4.36 (9 votes)
7 Feb 2009LGPL3
This article describes HtmlTextBlock which is a WPF TextBlock that can parse a limited set of HTML tags and display them.
htmltextblock/mainscreen.jpg

Introduction

This article describes HtmlTextBlock which is a WPF TextBlock that can parse a limited set of HTML tags and display them.

Background

I was working on a custom progress dialog, which contains a Header, Message, Progress and some action buttons.

To make it look better, I want the message to support some text format, and I want it to be changeable at runtime, but it seems impossible using TextBlock.

htmltextblock/background.jpg

I then Googled how to use HTML in WPF but most solutions told me to use WebBrowser, which is a bit of an overkill for my purpose.

Then I remembered an abandoned project I wrote a few years ago (mostly because I moved to WPF) , which tried to recreate FlowDocument in .NET 2, and load HTML document (my main purpose, the component was named QzMiniHtml2).

Surprisingly, with very few modifications (mostly using import), this .NET 2 project worked nicely with WPF, just as you can see above.

Because of this, the original project is included as well.

How to Use?

The control is similar to TextBlock except you set the HTML property instead of Text.
Remember to use [ ] bracket instead of < >.

<Window x:Class="HtmlTextBlockTestProj.Window1"

    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"

    xmlns:uc="http://www.quickzip.org/UserControls"

    Title="HtmlTextBlockTest" Height="250" Width="450">
    <DockPanel>
        <uc:HtmlTextBlock Html="{Binding Text, ElementName=tb}"

                 DockPanel.Dock="Top" Loaded="HtmlTextBlock_Loaded" />
        <TextBlock Text="[b] [i] [u] [a href=xx] [br] supported."

                 DockPanel.Dock="Bottom" />
        <TextBox TextWrapping="Wrap" AcceptsReturn="True"

                  VerticalScrollBarVisibility="Visible"

                  x:Name="tb"

        Text="The [i][u]quick brown fox[/i][/u] jumps over the [b]lazy dog[/b]" />
    </DockPanel>
</Window>         

How It Works?

The component actually included an HTML parsing engine inside, which translates HTML string to WPF's Bold, Italic, Underline, Hyperlink, LineBreak Inline (more can be added in future, you can do it yourself easily, see below.)

The conversion part is simple.

1) private Inline UpdateElement(HtmlTag aTag)
2) {
3)   Inline retVal = null;

4)   switch (aTag.Name)
5)   {
6)     case "text" :
7)       retVal = new Run(aTag["value"]);
8)       if (currentState.Bold) retVal = new Bold(retVal);
9)       if (currentState.Italic) retVal = new Italic(retVal);
0)       if (currentState.Underline) retVal = new Underline(retVal);
A)       break;
B)     case "br" :
C)       retVal = new LineBreak();
D)       break;
E)   }

F)   if (currentState.HyperLink != null && currentState.HyperLink != "")
G)   {
H)     Hyperlink link = new Hyperlink(retVal);
I)     link.NavigateUri = new Uri(currentState.HyperLink);
J)     retVal = link;
K)   }
L)    return retVal;
M) }         

First, please note that:

  • The input (aTag) is a Text or LineBreak(br), if the tag is a text, Tag["value"] is the text it holds.
    Bold, Italic, etc. can also be represented by HtmlTag, but they won't be executed here.
  • CurrentState holds the style affecting the TextTag, etc.

So if the tag is text (line 6):

  • it will generate a Run (which can contain format or unformat text, and unformat in this case) (line 7)
  • if it's bold, italic and underline, it will construct them, and using last Inline (Abstract class, Run, Bold, etc. inherited from it), so it contains the property.

When the Inline is returned (Line L):

  • It will be added to your HtmlTextBlock.Inlines collection.

History

  • 08-02-09 Initial version

License

This article, along with any associated source code and files, is licensed under The GNU Lesser General Public License (LGPLv3)

Share

About the Author

Leung Yat Chun (Fainx)
Founder FANIX.ME
Hong Kong Hong Kong
From the end of the Universe we have Fainx and Quick Zip.
http://www.FANIX.ME
Quickzip.org is stolen by and moved to Fanix.me.
--
May Thy Lord Your God be blessed always.

DirectoryInfoEx - [1.0.27]
WPF FileExplorer3 - [3.0.19]
WPF HtmlTextBlock - [Codeplex]
WPF ListView MultiSelect - [0.4]
WPF UIEventHub MultiSelect/DragDrop w Touch support - [3.0]
WPF BreadcrumbFolderTextBox - [2.5]
WPF BreadcrumbTree and Breadcrumb
WPF Aero Titlebar - [0.2]

Comments and Discussions

 
GeneralRe: extensions Pin
Lee_Nover24-Mar-09 3:45
memberLee_Nover24-Mar-09 3:45 
GeneralRe: extensions Pin
Leung Yat Chun (Fainx)25-Mar-09 9:20
professionalLeung Yat Chun (Fainx)25-Mar-09 9:20 
GeneralRe: extensions Pin
Bob Ranck4-Apr-09 9:26
memberBob Ranck4-Apr-09 9:26 
GeneralRe: extensions Pin
Leung Yat Chun (Fainx)5-Apr-09 20:45
professionalLeung Yat Chun (Fainx)5-Apr-09 20:45 
QuestionFlow document? Pin
Member 17809897-Feb-09 21:32
memberMember 17809897-Feb-09 21:32 
AnswerRe: Flow document? Pin
Leung Yat Chun (Fainx)7-Feb-09 22:39
professionalLeung Yat Chun (Fainx)7-Feb-09 22:39 
GeneralRe: Flow document? Pin
Member 17809898-Feb-09 22:38
memberMember 17809898-Feb-09 22:38 
GeneralRe: Flow document? Pin
Leung Yat Chun (Fainx)9-Feb-09 9:04
professionalLeung Yat Chun (Fainx)9-Feb-09 9:04 
Greetings

You are right, I remembered I read this class before but it didn't came up to my mind when I designing the component. (I am still new to WPF anyway Smile | :) )

Anyway, as I ve completed the component, I will continue use it, are there similar class that can parse html string?

Thanks.

Regards
Joseph Leung


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.

Article
Posted 7 Feb 2009

Tagged as

Stats

129.8K views
34 bookmarked