CVisValidEdit : Visual Validator

Overview

CVisValidEdit is an edit control with a difference - there is visual cues & validation (both built in & customisable). The edit control offers additional support for displaying & converting several numeric types.

• double < -- > Binary < -- > long
• double < -- > Hexadecimal < -- > long
• double < -- > Octal < -- > long
• double < -- > Float < -- > long

The visual cues are by way of different colour brushes to indicate the error type.

There are numerous options that make this control a synch to use!

CVisValidEdit Usage...

#include the header "VisValEdit.h" where required.

Add a standard edit control to your dialog.

Using the class wizard, attach a member variable select 'Control' from the category combo & select CVisValidEdit as the variable type (if CvisValidEdit is not in the list, just choose CEdit & change the type in your class definition)

Set any options required before displaying your dialog.

Add functions to handle UWM_VVE_DO_CUSTOMVALIDATION & UWM_VVE_VALIDITY_CHANGED UWM_VVE_CONTENT_CHANGED (follow links for example)

Display your dialog.

CVisValidEdit Functions...

BOOL IsValid();
BOOL IsValidLength();
BOOL IsValidSyntax();

void DoValidation(BOOL bRedraw = TRUE);

 int  CheckRange();
 int  CheckRange(LPCSTR lpszVal);
 static int CheckRange(VVEset vveset, LPCSTR lpszVal);
 static int CheckRange(VVEset vveset, double dVal);
 void DisplayMoreInfo(BOOL bAddOnExtraInfo = TRUE);
 void GetMoreInfoString(VVEset vveset, CString &sInfoString, BOOL bAddOnExtraInfo = TRUE );
 void SetMoreInfoString(VVEset vveset, LPCTSTR sNewInfoString = NULL );//NULL = reset to default
 void SetContextInfo(VVEbrush ErrBrush, LPCSTR sErrMesg);
 void GetContextInfo(VVEbrush ErrBrush, CString &sErrMesg);
 void GetCurContextInfo(CString &sErrMesg);
 void SetEnableContextInfo(BOOL bEnable = TRUE);
 BOOL GetEnableContextInfo();
 void SetEnableRangeChecking(BOOL bEnable = TRUE);
 BOOL GetEnableRangeChecking();
 void SetCustomErrorIsValid(int iCustomWhich, BOOL bSetIsValid = TRUE);
 BOOL GetCustomErrorIsValid(int iCustomWhich, BOOL &bCustomIsValid );
 void DoValidation(BOOL bRedraw = TRUE);//explicit request
 void SetEnableLengthCheck(BOOL bEnable = TRUE);
 BOOL GetEnableLengthCheck();
 BOOL SetBrushColour(VVEbrush brWhich, COLORREF NewColour);
 COLORREF GetBrushColour(VVEbrush brWhich);
 BOOL SetWindowValue(double fSetVal);
 BOOL SetWindowValue(long lSetVal);
 BOOL SetWindowValue(unsigned long lSetVal);
 BOOL GetWindowValue(double &fVal);//returns FALSE if string is too large for double
 BOOL GetWindowValue(long &lVal);//returns FALSE if string is too small/large for long
 BOOL GetWindowValue(unsigned long &lVal);//returns FALSE if string is too large for ulong
 BOOL GetAllCharEntry();
 void SetAllCharEntry(BOOL bAllowAllCharsIn = TRUE);
 BOOL GetEmptyValid();
 void SetEmptyValid(BOOL bEmptyOK = TRUE);
 void SetDisableValidation(BOOL bNoValidation = TRUE);
 BOOL GetDisableValidation();
 void SetCustomValidation(BOOL bUseCustom = TRUE);
 BOOL GetCustomValidation();
 void SetValidCharSet(VVEset vveset, LPCTSTR cstrCustomChar = NULL);//NULL = reset to default
 void SetValidSet(VVEset vveset);
 VVEset GetValidSet();
 void SetValidChars(LPCTSTR cstrCustomChar);
 void GetValidChars(CString & strValidChars);
 void SetTextLenMinMax(int iMin = VVE_DEF_MINLEN, int iMax = VVE_DEF_MAXLEN);
 int	 GetTextMinLen();
 int  GetTextMaxLen();

enum VVEbrush {BR_ERROR,
    BR_EMPTY,
    BR_VALID,
    BR_INVALIDSYNTAX,
    BR_INCOMPLETE,
    BR_SHORT,
    BR_LONG,
    BR_RANGEERR,
    BR_CUSTOM_ERR1,
    BR_CUSTOM_ERR2};
    //return constants - each has a matching brush 
    //(BR_INCOMPLETE, BR_SHORT, BR_LONG, BR_RANGEERR are same brush only context info changes).

enum VVEset {SET_CUSTOM,
    SET_ALLCHAR,
    SET_ALPHANUM,
    SET_ALPHA,
    SET_DECIMAL,
    SET_SDECIMAL, //Signed
    SET_HEXADECIMAL,
    SET_OCTAL,
    SET_BINARY,
    SET_FLOAT };

UWM_VVE_DO_CUSTOMVALIDATION

• wParam - pointer to a notification message structure MNHDR (code contains enumerated value of current error brush see VVEbrush)
• lParam - const pointer to the widow text
• Return - Expected return is a constant of the VVEbrush enumeration

This message is sent to the parent when custom validation option is set & validation of the input is required. UWM_VVE_DO_CUSTOMVALIDATION can be intercepted by the inclusion of a MESSAGEMAP entry e.g.

In your MESSAGEMAP (in *.cpp file)

ON_MESSAGE(UWM_VVE_DO_CUSTOMVALIDATION, OnDoValidation)

  //}}AFX_MSG   //below here
  afx_msg LRESULT OnDoValidation(WPARAM wParam, LPARAM lParam);//add declaration here 
  DECLARE_MESSAGE_MAP()  //above here

In your *.cpp file

LRESULT CValidatorDlg:: OnDoValidation(WPARAM wParam, LPARAM lParam)
{
  //pointer to an NMHDR structure
  LPNMHDR nm = (LPNMHDR) wParam;

  //pointer to const string (text in control)
  CString s((LPCSTR) lParam);

  //regardless of idfrom, this routine says empty is empty 
  if(s. GetLength() == 0)
      return (LRESULT) CVisValidEdit::BR_EMPTY";

  //nm contains the idfrom & hwnd from of the control 
  // requesting validation.
  switch(nm-> idFrom)
  {
      case IDC_SWEAR_WORD_INHIBITING_EDIT_BOX:
      if(s.Find("SHIT"))//Word not tolerated - return custom error 1 
          return CVisValidEdit::BR_CUSTOM_ERR1; //return error
      case IDC_A_NAME_EDIT_BOX:
      if(s.Find("0123456789") == -1)//No numbers in your name 
          return CVisValidEdit::BR_CUSTOM_ERR1; //return error
  };
}

UWM_VVE_VALIDITY_CHANGED

• wParam - pointer to a notification message structure MNHDR (code contains enumerated value of current error brush see VVEbrush)
• lParam - The new valid state. 0 = Invalid, other = Valid
• Return - void (0)

In your MESSAGEMAP (in *.cpp file)

ON_MESSAGE(UWM_VVE_VALIDITY_CHANGED, OnValidChanged)

In your *.h file

  //}}AFX_MSG   //below here
  afx_msg LRESULT OnValidChanged(WPARAM wParam, LPARAM lParam);//add declaration here ok
  DECLARE_MESSAGE_MAP()  //above here

In your *.cpp file

  afx_msg LRESULT OnValidChanged(WPARAM wParam, LPARAM lParam)
  {
      if(((LPNMHDR)wParam)->idfrom == IDOK )
          OkButton.EnableWindow(lParam);
  }

UWM_VVE_CONTENT_CHANGED

• wParam - pointer to a notification message structure MNHDR (code contains enumerated value of current error seeVVEbrush)
• lParam - The valid state. 0 = Invalid, other = Valid
• Return - void (0)

In your MESSAGEMAP (in *.cpp file)

  ON_MESSAGE(UWM_VVE_CONTENT_CHANGED, OnContentChanged)

In your *.h file

  //}}AFX_MSG   //below here
  afx_msg LRESULT OnContentChanged(WPARAM wParam, LPARAM lParam);//add declaration here ok
  DECLARE_MESSAGE_MAP()  //above here

In your *.cpp file

  afx_msg LRESULT OnContentChanged(WPARAM wParam, LPARAM lParam)
  {
      LPNMHDR pNM = (LPNMHDR)wParam;
      if( pNM ->idfrom == IDC_NAME && pNM->code == CVisValidEdit::BR_EMPTY)
          MessageBox("You must enter your name");
  }

Downloads