Click here to Skip to main content
6,595,854 members and growing! (18,531 online)
Email Password   helpLost your password?
Languages » C / C++ Language » General     Intermediate

FlexMaskEditBox - a masked edit control

By Ted Schopenhouer

A very flexible MaskTextbox control
VB, Windows, .NET 1.0, .NET 1.1, Dev
Posted:28 Apr 2003
Views:235,250
Bookmarked:39 times
Announcements
Loading...
 
Search    
Advanced Search
Add to IE Search
printPrint   add Share
      Discuss Discuss   Broken Article?Report  
39 votes for this article.
Popularity: 6.65 Rating: 4.18 out of 5
2 votes, 5.1%
1
1 vote, 2.6%
2
1 vote, 2.6%
3
11 votes, 28.2%
4
24 votes, 61.5%
5

Introduction

Why will you have to use a MaskEditBox? It's not a professional look when the end user can give alphanumeric input when numeric input is required.

It's a piece of cake to validate the input and/or give feedback of wrong input to the type goats.

Using the code

There are 3 types of input viz. alphabetic, numeric and date. The behavior of the three types are different when typing.

When using the numeric type together with decimals (example mask:= "9999D##") and the end user types the decimal notation a (.) or (,) depending on international setting, the cursor automatically goes to the decimal point. Also the input characters are drawn from right to left. This is an example of validation using the FlexMaskEditBox and give feedback to the end user by ErrorTxt.

 
Private Sub FlexMaskEditBox1_Validating(ByVal sender As Object, 
    ByVal e As System.ComponentModel.CancelEventArgs) 
    Handles FlexMaskEditBox1.Validating, FlexMaskEditBox2.Validating, 
    FlexMaskEditBox3.Validating, FlexMaskEditBox5.Validating
    
    Dim fmb As FlxMaskBox.FlexMaskEditBox = CType(sender, 
        FlxMaskBox.FlexMaskEditBox)
    
    If fmb Is FlexMaskEditBox1 Then
        Try
            Dim Value As Decimal = Decimal.Parse(fmb.Text)
            If Value < 201.13 OrElse Value > 4027.55 Then
                fmb.ErrorTxt = "Value MUST between 201.13 
                                    and 4027.55"
                If CheckBox1.Checked Then e.Cancel = True
            Else
                fmb.ErrorTxt = ""
            End If
        Catch 'normal, this will never been evaluate

            fmb.ErrorTxt = "There is no Valid Value given"
            If CheckBox1.Checked Then e.Cancel = True
        End Try
    ElseIf fmb Is FlexMaskEditBox2 Then
        Try
            Dim dt As DateTime = DateTime.Parse(fmb.Text)
            If dt.Year < 1980 OrElse dt.Year > 2010 Then
                fmb.ErrorTxt = "The Range of valid Years 
                                    must be between 1980 an 2010"
                If CheckBox1.Checked Then e.Cancel = True
            Else
                fmb.ErrorTxt = ""
            End If
        Catch
            fmb.ErrorTxt = "Not A Valid Date, Try Again!"
            If CheckBox1.Checked Then e.Cancel = True
        End Try
    ElseIf fmb Is FlexMaskEditBox3 Then
        With fmb
            If .Text.Replace(" ", "").Length < 6 Then
                .ErrorTxt = "Not All Characters Are Given"
                If CheckBox1.Checked Then e.Cancel = True
            Else
                .ErrorTxt = ""
            End If
        End With
    ElseIf fmb Is FlexMaskEditBox5 Then
        With fmb
            If Not Regex.IsMatch(.Text, "^([\w-]+\.)*?
                    [\w-]+@[\w-]+\.([\w-]+\.)*?[\w]+$") Then
                    
                .ErrorTxt = "No valid Email address"
                If CheckBox1.Checked Then e.Cancel = True
            Else
                .ErrorTxt = ""
            End If
        End With
    End If
End Sub

Using the Mask

(#) - (chr 48 - 57)

(9) - (chr 48 - 57) (-) minus sign

(?) - (chr 65 - 90) (chr 97 - 121)

(A)(C)  - (chr 65 - 90) (chr 97 - 121) (chr 48 - 57)

(a)(c)  - (chr 65 - 90) (chr 97 - 121) (chr 48 - 57) (chr 32 )

(&) - (chr 32 - 126) (chr 128 - 255)

(\)  Next char will be no mask char

(>) All chars next to the > sign will transformed in upper-case
    until the next mask char is an (<) or (\) or (|)

(}) Next 1 Char will transformed in upper-case
    
(<) All chars next to the < sign will transformed in lower-case
    until the next mask char is an (>) or (\) or (|)
    
(|) Stops next chars from Upper or Lower casing

({) Next 1 Char will transformed in lower-case

(d)(D) Decimal Point (#####d99) = 12345.67 or 12345,67  
       (depending on country settings)

(g)(G) Group Separator (##g###g###d##) = 12.345.678,90 or 12,345,678.90
       (depending on country settings)
  
(s)(S) Date Separator (##s##s####) = 12-12-2000 or 12/12/2000
       (depending on country settings)

So when you want to include characters in your mask, which are also mask signs, use the \ in front. For instance, ##s##s1\9## (the 9 is also a mask sign, but the 1 is not)

Including the FlexMaskEditBox into your project

Instructions for using the FlexMaskEditControl control in a new project:

  1. Start Microsoft Visual Studio .NET.
  2. Open the FlexMaskEdit.vbproj project.
  3. On the Build menu, click Build Solution to build FlexMaskEdit.dll.
  4. Close the project.
  5. Create a new Windows application using Visual Basic .NET. Form1 is created by default.
  6. On the Tools menu, click Customize Toolbox.
  7. Select the .NET Framework Components tab.
  8. Click the Browse button.
  9. Navigate to the folder where FlexMaskEdit.dll was built (it should be the bin folder located underneath the location where you unzipped the project).
  10. Select FlexMaskEdit.dll and click Open. It will automatically add it to the selected components list and check the item for you.
  11. Click OK to close the Customize Toolbox dialog box. Note that the FlexMaskEdit control now appears on your Toolbox. That's all, now you can draw the FlexMaskEditBox like you do a TextBox.

History

  • Original the source code was written in VB6 (a few years ago) but re-written for better performance.

Acknowledgement

  • Many thanks to Hans Scholten (Email: wonen@wonen.com) for his input.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

About the Author

Ted Schopenhouer


Member

Location: Netherlands Netherlands

Other popular C / C++ Language articles:

Article Top
You must Sign In to use this message board.
FAQ FAQ 
 
Noise Tolerance  Layout  Per page   
 Msgs 1 to 25 of 68 (Total in Forum: 68) (Refresh)FirstPrevNext
GeneralTotally useless : native in windows ! Pinmemberkilt7:45 20 Feb '09  
GeneralRe: Totally useless : native in windows ! PinmemberMizan Rahman4:41 22 Sep '09  
GeneralIs there any version for VBA Excel? Pinmemberironyq@wp.pl5:44 23 Jun '07  
GeneralError using flexeditcontrol PinmemberThe Shrink13:59 1 Mar '07  
GeneralRe: Error using flexeditcontrol PinmemberAlbanaco10:38 31 May '07  
GeneralCan i remove $ sign Pinmemberdevagnanam19:17 11 Jan '07  
QuestionObjet disapears when I copy my projet in a new computer PinmemberAdrian_Mia11:51 31 Jul '06  
QuestionFlexMaskEdit control PinmemberJohnMcPherson111:50 9 Mar '06  
AnswerRe: FlexMaskEdit control PinmemberDeester6:33 25 May '06  
GeneralVersion for VB6? PinmemberMichael F. Henning11:22 24 May '05  
GeneralError when copy control Pinmembervicopocho9:57 30 Mar '05  
GeneralFlexMaskEditBox on win98 Pinmembervicopocho9:50 30 Mar '05  
GeneralLost Focus with "Enter" Pinmembersamoeln0:20 16 Dec '04  
GeneralDeploying FlexMaskEditBox Pinmemberrschaefer2014:05 7 Oct '04  
Generaldate mask showing funny PinmemberLonnieJohnson8:29 7 Sep '04  
GeneralRe: date mask showing funny Pinmemberradaremtjcw14:36 30 Jan '05  
GeneralRe: date mask showing funny PinmemberGustavoBalbinot2:37 14 Jun '05  
GeneralRe: date mask showing funny PinmemberComputerNerd9270810:34 29 Jul '05  
Generalcannot access mask Pinmembersconnor15:50 30 Aug '04  
GeneralFlex Edit Box on Tabpage Pinmemberamwoodwork5:38 29 Jul '04  
GeneralRe: Flex Edit Box on Tabpage PinmemberHaggardPete1:37 10 Aug '04  
GeneralRe: Flex Edit Box on Tabpage PinmemberTheSpiritual15:44 12 Nov '04  
GeneralFlexMaskedit - Problems With Numerics PinmemberHaggardPete23:58 27 Jun '04  
GeneralRe: FlexMaskedit - Problems With Numerics PinmemberHaggardPete3:17 28 Jun '04  
GeneralRe: FlexMaskedit - Problems With Numerics Pinmemberrandyj8:52 30 Jul '04  

General General    News News    Question Question    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

PermaLink | Privacy | Terms of Use
Last Updated: 28 Apr 2003
Editor: Nishant Sivakumar
Copyright 2003 by Ted Schopenhouer
Everything else Copyright © CodeProject, 1999-2009
Web19 | Advertise on the Code Project