Masked TextBox

I found a new control for the AvalonControlsLibrary, the MaskedTextBox. I found this control while reading one of the best WPF books around from Matthew MacDonald.

The MaskedTextBox is a normal WPF textbox (in fact it inherits from the TextBox class) that formats the text entered by the user (and also strings set from the Text property programmatically). For example if you type 1234567890 into a masked textbox that has a U.S. telephone number mask, the text will be displayed as (123) 456-7890. To check out how you can create Masks have a look at this url.

To create this control I use the MaskTextProvider which is a .Net class. The MaskedTextProvider takes care of validating the string and also to format the text entered accordingly to the mask specified.

The MaskedTextBox has a Mask property which accepts a string. This string (and the mask property) is then used to create a MaskedTextProvider that can format the user input.

In order to intercept the user input, I override the OnPreviewTextInput method and apply the mask to the text that has been entered. As you can see this is 80% of the control’s code.

/// <summary>
/// override this method to replace the characters enetered with the mask
/// </summary>
/// <param name=”e”>Arguments for event</param>

protected override void OnPreviewTextInput(TextCompositionEventArgs e)
int position = SelectionStart;
MaskedTextProvider provider = MaskProvider;
if (position < Text.Length)
                position = GetNextCharacterPosition(position);
if (Keyboard.IsKeyToggled(Key.Insert))
if (provider.Replace(e.Text, position))
if (provider.InsertAt(e.Text, position))
                 position = GetNextCharacterPosition(position);
         RefreshText(provider, position);
         e.Handled =

I also override the OnPreviewKeyDown method of the TextBox in order to handle special characters such as delete and backspace.Yet we have a problem! The problem is that if the user uses cut or paste the mask will not be applied until the next keystroke. So the workaround (described in the book) shows us how we can use CommandBinding to suppress these features. I really liked the idea because this shows us how commands can give us such power in our hands. So to suppress these features we have to do the following///<summary>
/// Default constructor
public MaskedTextBox()
           //cancel the paste and cut command
CommandBindings.Add(new CommandBinding(ApplicationCommands.Paste, null, CancelCommand));
new CommandBinding(ApplicationCommands.Cut, null, CancelCommand));
//cancel the command
private static void CancelCommand(object sender, CanExecuteRoutedEventArgs e)
           e.CanExecute =
           e.Handled =
 As you can see all you have to do is handle the command yourself and just set the CanExecute to false and Handled to true. Nice!Another problem is how we can force the Text property to apply the Mask when set programmatically. Since we only handle the OnPreviewTextInput this is not catered for. And here comes the FrameworkMetaData. Basically we can override the default meta data for the Text property and apply a CoerceValueCallback that apply the mask to the text./// <summary>
/// Static Constructor
/// </summary>
static MaskedTextBox()
             //override the meta data for the Text Proeprty of the textbox
FrameworkPropertyMetadata metaData = new FrameworkPropertyMetadata();
            metaData.CoerceValueCallback = ForceText;
typeof(MaskedTextBox), metaData);
//force the text of the control to use the mask
private static object ForceText(DependencyObject sender, object value)
MaskedTextBox textBox = (MaskedTextBox) sender;
if (textBox.Mask != null)
MaskedTextProvider provider = new MaskedTextProvider(textBox.Mask);
string) value);
return provider.ToDisplayString();
return value;
 This shows us how powerful Dependency properties are. I was really excited about this one since it’s my first time to play around and override property meta data explicitly 🙂

And that’s basically it.Eventually I will implement a real MaskedTextBox by inheriting from the TextBoxBase but for now this will do the trick for developers that need this control.Hope you find this control useful.
Downlaod control demo and full source code

56 thoughts on “Masked TextBox

  1. Hi,

    You made a little mistake, because if space is pressed the PreviewTextInput Event will not be raised, so you have to handle that in the PreviewKeyDown Event. Space is the only character of these special keys, which could valid for a mask.

    So I wrote a little adaptation:
    protected override void OnPreviewKeyDown(KeyEventArgs e)

    MaskedTextProvider provider = MaskProvider;
    int position = SelectionStart;

    if (e.Key == Key.Delete && position 0)
    if (provider.RemoveAt(position))
    RefreshText(provider, position);
    e.Handled = true;
    else if (e.Key == Key.Space)
    if (provider.InsertAt(‘ ‘, position))
    RefreshText(provider, position);
    e.Handled = true;


  2. Sorry I had a problem to copy the code snipped,
    so second try:

    protected override void OnPreviewKeyDown(KeyEventArgs e)

    MaskedTextProvider provider = MaskProvider;
    int position = SelectionStart;

    if (e.Key == Key.Delete && position 0)
    if (provider.RemoveAt(position))
    RefreshText(provider, position);
    e.Handled = true;
    else if (e.Key == Key.Space)
    if (provider.InsertAt(‘ ‘, position))
    RefreshText(provider, position);
    e.Handled = true;

  3. Your MaskedTextBox behaves different than the WinForms MaskedTextBox.
    The ability to select a character and overwrite it is vital for masks like ‘L00’ that allow a letter and two digits.
    If one enters X99 and wants to change it to Y99, this can be done with WinForms by selecting the X and typing a Y.
    With your control the user probably will have to delete all three characters and type Y99 (one cannot delete the X from X99 because a digit would move into the letter position of the mask string).

  4. Hi, I am not very sufficient in C# and If anyone can help me that would be the great. The question is:
    Write the mask for a masked Textbox that can produce “(AB)-(2)-(888)” as a possible output.

  5. Hi Marlon,
    Thanks for the very useful control of yours.
    I am using the MaskedTextBox in one of our projects.
    I need to disable the Mask from appearing on the textbox by default(the mask should appear when the control gets focus)
    Second is, the textbox should be able to accept Space when the Mask is to ‘CCCCCCCC’.

    Thanks in advance,

  6. It may be easier but it depends what you want to do…. Since this control is 100% WPF you can do anything you want with it… (control templates etc…)

    So I guess it is just a matter of what you want to do…

  7. Hi All,

    We are using masked wpf textbox (from avalon control library) and is masked to act like ip address control the mask is 990.990.990.990 and i want to achieve from it standard windows ip control navigation/vaidation behavior like-

    1) Ctrl + arrow keys and ‘.’ should select/navigate to neighbouring octet as in standard windows ip control
    2) On TAB key press focus should leave the control. In my case it is going to next textbox in the sequence.
    3) The bottom mask line should not appear.
    4) Validation should fire when we move out of octet having value more than 255
    5) The cursor position should always be in middle of the octet portion and if you do not type anything and leave it as it is i.e. blank and press arrow keys it will go to neighbouring octets and each octet version should be center-aligned.
    6) Select first octet when the masked textbox get in focus.

    Would it be fairly complex to do this kind of stuff ?
    If not please suggest me how to achieve this features.

    Thanks in advance.


  8. This example (and the latest code for the AvalonControlsLibrary) does not work how I would expect it to. Especially when comparing it to the winform masked textbox.

    Lets say you have a string property (call it MyTime) bound to this control. The xaml looks like so.

    MyTime is just a string property on the codebehind or whatever you are using as a DataContext.

    The second textbox is also bound to that property, this is just for viewing what is actually set on the bound property.

    Now, the Mask is “90:00” which means the first digit is optional and could be a space, the rest of the fields are required digits.

    If i enter 2:33 into the textbox, the masked textbox shows “_2:33” and the second (unmasked) textbox bound to the same property shows “_2:33”.

    This is not what I would expect, shouldn’t the bound value be “2:33”? I would not expect the mask placeholders to be returned when I try to get the value of .Text. If I’m using this control, and I have optional elements in my mask, I don’t want to have to strip out extraneous underscores from my result.

    Compare this to the winform masked textbox, using the same mask. If I enter 2:33, and I examine the .Text property of the control via a breakpoint, it returns me “2:33”, not “_2:33”.

    I’ve tried to remedy this, but cannot quite seem to get it. I could add a separate property to get the value I want, but I feel like it should work just using the .Text binding.

    Perhaps the author or someone else has an idea?

  9. The MaskedTextBox does not inherit the default style as the rest of the controls on a page. Also, it has no header / label- you have to create a compound control for it.

    Any ideas why this is the case?

  10. I’m facing a problem using it when i bind a property to Text.. like this:

    The mask is shown correctly, but after i type my date, and go to next control, the date disappear!

  11. i am using MaskedTextBox for phone numbers
    but on saving the value i want to take the original text not the formatted one ,any ideas about how to do it??

  12. Pingback: WPF – Masked Textbox Behavior | Blindmeis's Blog

  13. I must say you have a cool post. This hit the spot and then some! Thanks for posting this and sharing it with the world. I�ve just bookmarked your site. And I will check back soon to read your other articles. Keep up your awesome work.

  14. Pingback: Contrôles manquants en WPF | Blog de JP Gouigoux

  15. My developer is trying to persuade me to move to .
    net from PHP. I have always disliked the idea because of the expenses.

    But he’s tryiong none the less. I’ve been using WordPress on several websites for about a year and am
    nervous about switching to another platform. I have heard excellent
    things about Is there a way I can import
    all my wordpress posts into it? Any help would be really appreciated!

  16. I was wondering if you ever considered changing
    the page layout of your site? Its very well written; I love what youve
    got to say. But maybe you could a little more in the way of content so people could connect with it better.
    Youve got an awful lot of text for only having one or 2 images.
    Maybe you could space it out better?

  17. Yesterday, while I was at work, my sister stole my apple ipad and tested to see if it can survive a forty foot drop, just so she can be a youtube sensation.
    My iPad is now broken and she has 83 views. I know
    this is completely off topic but I had to share it with someone!

  18. “Masked TextBox | C# Disciples” certainly got me personally simply hooked with ur internet page!
    I actuallywill probably wind up being returning considerably more regularly.
    Thanks -Ted

  19. I love what you guys are usually up too. This sort of clever work and coverage!
    Keep up the amazing works guys I’ve incorporated you guys to blogroll.

  20. Apart from the high quality products this highly
    reputed web storee also allows thhe client to
    get his favorite fashion item at an affordable by using Freecultr coupon code.
    We offer a career in vogue design in a variety of various fields.
    s preferences using a commercial state of mind and voila you will possess landed yourself in marketing fashion operate in no

  21. Foods, including snack crackers, are either organic or not.
    The Chivas series (named after Mexican club CD Chivas Guadalajara) is on the feet of about one-third of my
    players. Cursing on the playing field is ill-advised, unless
    all players agree that cursing is allowable.

  22. When I originally commented I clicked the “Notify me when new comments are added” checkbox and
    now each time a comment is added I get several emails with the same comment.
    Is there any way you can remove me from that service? Cheers!

  23. I personally have quite a number of hobbies which include card-making, fishing, gardening, baking, preserving,
    jewellery making, jigsaws, collecting salt & pepper shaker sets and papertole.

    If you want to see what all the fuss is about, try slipping into some
    fur and experiencing the “tangible luxury” of these coats.
    If you act like a man who can have his pick of women, then chances are, you

  24. Perhaps up to now any time you were forced to rely upon main points in your own local shop
    you can actually, the difference is days available to get swimwear
    on loads of various websites online, solely allowed research one and turn not really over joyed when using the swimwear you have got.
    This ensures that they are incredibly supportive as well as having a lot of versatility.
    Hence, a very important to establish the right bathing suit for each various outing.

  25. The needs for Protyein is greater att certain stags of life, like during adolesecense each time a person is
    growing, or when a person is dealing with an illness or accident.
    As with any food, some dogs might have an intolerance but generally speaking, garlic and nutritional yeast
    are incredibly good for dogs. 35 minute per mile pace will
    burn approximately 12.

  26. Hey! This is my first visit to your blog! We are a collection of volunteers and starting a new project in a community in the
    same niche. Your blog provided us valuable information to work on. You have done a wonderful job!

  27. I have been exploring for a little bit for any high quality articles or blog posts in this kind of
    house . Exploring in Yahoo I ultimately stumbled upon this
    web site. Reading this info So i’m satisfied to express that I’ve an incredibly just right uncanny feeling I came upon just what I needed.
    I most without a doubt will make sure to do
    not put out of your mind this website and provides it a glance regularly.

  28. What’s up every one, here every one is sharing such
    experience, so it’s pleasant to read this webpage, and I used to pay
    a quick visit this web site daily.

  29. I do acceрt as true with all of the ideas you’ve presentеd in your post.

    They are very convincing and can certainly work.

    Still, the posts are verу quick for starters. May you please ⅼengthen them a bit fгom sᥙbsequᥱnt
    time? Thanks for the post.

  30. Riǥht noա it looks like Druρal іѕ the toр blogging pⅼatform avaіlable right now.
    (from what I’ve read) Is that what you’re using on your blog?

  31. I’ve read several eхcellent stuff here. Certainly value
    ƅookmarking for reviѕiting. I wonder hoա a lot
    effort yoᥙ set to mаkе this kind of wоnderfuⅼ informative site.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s