// form/field map

BEGIN_REGEX_FORM(MyRegexForm)

RGXFIELD(IDC_ZIP,RGXF_REQUIRED,0)

RGXFIELD(IDC_SSN,0,0)

RGXFIELD(IDC_PHONE,0,0)

RGXFIELD(IDC_TOKEN,0,0)

RGXFIELD(IDC_PRIME,RGXF_CALLBACK,0)

RGXFIELD(IDC_FAVCOL,0,CMRegex::IgnoreCase)

END_REGEX_FORM()

逆风编程技术
　　这个宏定义了一个静态表格，表格描述每个编辑控制域。大多数情况下你只需要控制 ID，还要有地方放标志和 RegexOptions。例如，在 TestForm 中，邮政编码是必输域（RGXF_REQUIRED），质数（Prime Number）输入域使用回调（稍后会详细讨论），最喜爱的专栏作家（IDC_FAVCOL）指定 CMRegex::IgnoreCase，它使得大小写 不敏感。


Figure 3 Pietrek? I Think Not!

　　看着表格你可能想知道正则表达式在哪。回答是：在资源文件中。对于每个域/控制ID，CRegexForm 都期望有一个具有相同ID的资源串。资源串由五个子串组成，子串之间用新行符（''\n''）分隔。一般格式为：
“Name\nRegex\nLegalChars\nHint\nErrMsg”。以下是 IDC_ZIP 所用的串：

"Zip Code\n^\\d{5}(-\\d{4})?$\n[\\d-]\n##### or #####-####"

第一个子串“Zip Code”是域名。第二个“^\d{5}(-\d{4})?$”，是用于验证邮编的正则表达式。（在资源串中必须敲入两个反斜线，目的是转义正则表达式中反斜线）。第三个子串是另外一个正则表达式，用来描述合法字符。对于邮编来说，即是“[\d-]”，意思是允许数字和连字符（hyphen）。如果输入域无字符限制，你可以通过敲入两个连续的新行符（“\n\n”意思是空子串）省略 LegalChars 检查。第四个子串全部为工具提示串。最后你可以提供第五个子串，如果该输入域无效则显示错误信息。对于邮编来说，它没有错误信息，所以 CRegexForm 产生一个默认的信息，形式为“Should be xxx”，xxx 被工具提示替代。“Should be”本身即是另一个资源串（稍后还要说到）。这些子串中，只有第一个域是必输域。
　　为什么用资源串来保存所有信息，而不直接在域映射中编码处理呢？首先，将它放在映射中使得代码很笨拙。把这些乱七八糟的字符串放在不显眼的地方有利于代码更整洁。此外宏无法处理可选参数，根据你所用参数的多少，你需要多个宏，如：RGXFIELD3、RGXFIELD4 和 RGXFIELD5。这样不是太笨拙了嘛？使用资源串真正的好处在于容易本地化。翻译者可以翻译字符串并创建不同的资源 DLLs。甚至正则表达式本身都需要翻译（不同的国家和地域邮编可能是不同的），所以它们也放在资源串中。
　　此外，再让我顺便指出用正则表达式解析这些子串是多么容易。MFC 有一个 26 行的专门用来解析子串的函数 AfxExtractSubString，但 CRegexForm 使用 CMRegex 来做只要一行代码！

CString str;

str.LoadString(nID);

vector<CString> substrs = CMRegex::Split(str, _T("\n"));

　　现在 substrs[i] 是第 i 个子串，如果你想知道有多少个子串，调用 substrs.size()即可。我真的很高兴我包装了 Split 函数来返回 STL vector。
　　一旦你用 BEGIN/END_REGEX_FORM 定义了自己的域映射并编写了自己的资源串，下一步要做的就是在对话框中实例化 CRegexForm 并进行初始化：

// in OnInitDialog

m_rgxForm.Init(MyRegexForm, this, 

IDS_MYREGEXFORM, 

MYWM_RGXFORM_MESSAGE);

　　自然，CRegexForm 需要域映射并指向你的对话框；第二和第三个参数是另一个资源串和回调消息ID。与单独的域字符串一样，初始串由包含新行符分隔的多个子串组成。对于 TestForm，IDS_MYREGEXFORM 是“Error: %s\nRequired\nShould be: %s\nBad Value”。第一个子串“Error: %s”是错误前缀。CRegexForm 用来显示“Error: xxx,”，xxx 是实际的出错信息。第二个子串，“Required,”是一个词/短语，当该域为必输域（RGXF_REQUIRED）时使用。第三个子串“Should be: %s,”我前面已经描述过，CRegexForm 用它来产生出错信息。“Should be: xxx”中的 xxx 是域提示。最后一个子串，“Bad Value,”CRegexForm 可以用它来放任何信息，当域没有提示也没有出错信息时使用。用户是看不到此信息的，因为你肯定会为每一个域配一个提示或出错信息，对不对？