A masked edit control (2)


Desktop-as-a-Service Designed for Any Cloud ? Nutanix Frame

 Download Demo Project and Source (37k) or Download Source Only (4k)

Updated : 12th August 1998

The original source for this code came from Sam Claret's article A Masked Edit Control.

The class that I was originally interested in was his CTimeEdit that allowed the editing of hours and minutes in an edit control. His original code only allowed a maximum 23rd hour, and 59th minute, i.e. the standard 24 hour clock. There was no way of specifying a 12 hour clock or even a 48 hour clock.. For this reason I have added SetHours(int hrs), SetMins(int mins)to CTimeEdit to allow this, and SetTime(CString Date), and CString GetTimeStr() to extend the use with other time functions..

As with Sam's code...

	#include <afxdao.h>

in a header file such as stdafx.h. Then create a CEdit box in the dialog editor, and using ClassWizard declare a CEdit control variable for it such as m_EditCtrl.Next edit the relevant header file to change the control variable from CEdit to CTimeEdit.

In a fuction such as OnInitDialog either write...


To set the time and then to set the maximum hours and minutes write...


To return the time in a string rather than a COleDateTime object write...

	CString string = m_EditCtrl.GetTimeStr();

The default maximum hours are 24, and the default maximum minutes are 59.


Joe Ismert asked me how he could use this masked edit class to allow entry of, for example a telephone number. Well CDateEdit and CTimeEdit are both sub-classes of CMaskEdit. To create your own customised masked edit control you can either create your own sub-class of CMaskEdit for your own unique mask, or use CMaskEdit directly. The following Telephone Number, IP Address, and Post Code examples all use CMaskDirectly, however can be placed a their own unique sub-class for which either CDateEdit and CTimeEdit can be used as examples.

Telephone Number
Create a CMaskEdit control called for example m_EditPhoneCtrl. Then in OnInitDialog write...

  //CMaskEdit - Telephone Initialisation
  m_EditPhoneCtrl.m_bisTime    = FALSE;

  //For use with CTimeEdit
  m_EditPhoneCtrl.m_isdate     = FALSE;

  //For use with CDateEdit
  m_EditPhoneCtrl.m_bUseMask   = TRUE;

  //Set to use CMaskEdit
  m_EditPhoneCtrl.m_strMask    = "0000 0000000";            //The mask string
  m_EditPhoneCtrl.m_strLiteral = "____ _______";            //"_" char = character entry
                                                            //" " char = no character entry
  m_EditPhoneCtrl.m_str = 0116 2111111";                    //Initial value
  m_EditPhoneCtrl.m_strMaskLiteral = m_EditPhoneCtrl.m_str; //Backspace replace string

IP Address

Create a CMaskEdit control called for example m_EditIPCtrl. Then in OnInitDialog write...

  //CMaskEdit - IP Address Initialisation
  m_EditIPCtrl.m_bisTime        = FALSE;
  m_EditIPCtrl.m_isdate         = FALSE;
  m_EditIPCtrl.m_bUseMask       = TRUE;
  m_EditIPCtrl.m_strMask        = "999.999.999.999";
  m_EditIPCtrl.m_strLiteral     = "___.___.___.___";
  m_EditIPCtrl.m_str            = "209.66 .99 .126";
  m_EditIPCtrl.m_strMaskLiteral = m_EditIPCtrl.m_str;

Post Code

Create a CMaskEdit control called for example m_EditPCodeCtrl. Then in OnInitDialog write...

  //CMaskEdit - IPost Code Initialisation
m_EditPCodeCtrl.m_bisTime        = FALSE; m_EditPCodeCtrl.m_isdate         = FALSE; m_EditPCodeCtrl.m_bUseMask       = TRUE; m_EditPCodeCtrl.m_strMask        = "LL00 0LL"; m_EditPCodeCtrl.m_strLiteral     = "____ ___"; m_EditPCodeCtrl.m_str            = "LE12 7AT"; m_EditPCodeCtrl.m_strMaskLiteral = m_EditPCodeCtrl.m_str; m_EditPCodeCtrl.SetWindowText(m_EditPCodeCtrl.m_str);

CMaskEdit m_strMask
The member variable m_strMask specifies what type of characters can be written and where.

0 Digit only
9 Digit or space
# Digit or space or + or -
L Alpha only
? Alpha or space
A Alphanumeric
a Alphanumeric or space
& All printable characters


12th August 1998
   CMaskEdit : Added the use of backspace to replace what has already been typed with another string (by Rodney Fujimoto). The examples use the original string as a replacement,  however by default the replacement is blank, thus nothing will be replaced by the backspace key.
   Provided separate .zip file of masked.cpp and masked.h to demo .zip file.
   Updated demo .exe.

7th August 1998
   CTimeEdit : Added SetTime(CString Date), and CString GetTimeStr().
   CMaskEdit : Cured bug with "9" masks not allowing spaces.
   Updated article and demo .exe, added examples.

27th July 1998
Original Version

Last updated: 12 August 1998


  • There are no comments yet. Be the first to comment!

  • You must have javascript enabled in order to post comments.

Leave a Comment
  • Your email address will not be published. All fields are required.

Most Popular Programming Stories

More for Developers

RSS Feeds

Thanks for your registration, follow us on our social networks to keep up-to-date