MFC软件国际化的几个问题及其解决方案

作者:马健
邮箱:[email protected]
主页:https://www.cnblogs.com/stronghorse/

以前我以为PDG相关软件只会在国内流行,所以发行简体中文版足矣,没想到现在流传到繁体中文环境下去了,还被人报告在繁体中文Windows下,Unicode版软件界面出现乱码。所以上网查了一下国际化多语言用户界面(Multilingual User Interface,MUI)技术,发现还有一些问题需要解决,所以把解决过程记录下来,形成这篇笔记。

=============================================================

目前网上能查到的基于MFC的多语言用户界面(MUI)实现,基本上都是对同一个资源ID复制不同的语言备份,然后在应用初始化时调用SetThreadLocale(XP)、SetThreadUILanguage(Vista+)设置语言,让FindResource函数自动根据所设置的语言读取对应的资源。这样做能达到以下效果:

  1. 如果同一资源ID有不同语言的备份,则FindResource会自动按照所设置的语言选择一个,从而达到根据用户选项切换界面语言文字的目的。
  2. 对于afxdlgs.h中定义的公共对话框,包括文件选择、字体选择、打印设置、查找替换等,也会自动按照所设置的语言显示按钮和文字。

但也存在下列问题:

  1. 项目的字符集必须设置为Unicode,否则在非同族语言下不论怎么搞都是乱码。
  2. PropertySheet、MessageBox的按钮不管是用SetThreadLocale还是SetThreadUILanguage设置,都会显示Windows当前语言的文字,如英文Windows下显示的按钮文字就是OK而不是“确定”,即使已经用SetThreadUILanguage设置了简体中文。
  3. 受PropertySheet影响,打印机选择对话框(CPrintDialogEx)左下角的两个按钮也会按当前语言显示。
  4. SHBrowseForFolder中的标题、按钮、提示不管用SetThreadLocale还是SetThreadUILanguage设置,都会按照Windows当前语言显示。
  5. 如果在资源编辑器中设置了下拉框(ComboBox)的中文data,即简体中文的初始化文字,则在其他语言下会出现乱码,包括对话框(Dialog)、PropertyPage中的下拉框都是这样。

以上问题至少我目前没有在网上找到答案,所以下面的分析及解决方案除非特殊说明,均为原创。

一、ComboBox的中文data在其他语言下出现乱码的原因及解决方案

ComboBox初始化出现乱码的原因分析:

  1. 在CDialog::OnInitDialog()下断点,跟踪进去,可以看到一开始就调用CWnd::ExecuteDlgInit(LPCTSTR lpszResourceName)函数。
  2. 在CWnd::ExecuteDlgInit(LPCTSTR lpszResourceName)中,根据对话框ID来FindResource、LoadResource,LockResource,然后调用CWnd::ExecuteDlgInit(LPVOID lpResource)。
  3. 在CWnd::ExecuteDlgInit(LPVOID lpResource)中,关键是下面的代码:

 

#ifndef _AFX_NO_OCC_SUPPORT
else if (nMsg == LB_ADDSTRING || nMsg == CB_ADDSTRING)
#endif // !_AFX_NO_OCC_SUPPORT
{
// List/Combobox returns -1 for error
if (::SendDlgItemMessageA(m_hWnd, nIDC, nMsg, 0, (LPARAM) lpnRes) == -1)
bSuccess = FALSE;
}

因此:

  1. 尽管VC已经用Unicode编码保存资源文件(.rc文件),但资源文件的DLGINIT数据段,仍然按照传统采用ANSI编码保存combobox和listbox的初始data。
  2. 在CWnd::ExecuteDlgInit(LPVOID lpResource)函数中,读取到DLGINIT数据段中的ANSI编码字符串后,直接用ANSI版的SendDlgItemMessageA发消息对combobox和listbox进行初始化,即逐一插入初始化字符串。
  3. 反编译user32.dll可以看出,SendDlgItemMessageA内部是GetDlgItem、SendMessageA。
  4. 由于combobo已经设置成Unicode,SendMessageA自动按照当前代码页(ACP)转码成Unicode,而不是按SetThreadUILanguage所设置的语言转码,导致出现乱码。

解决方案有两种:

方案一:流行,但回避矛盾

既然MFC的初始化代码会导致乱码,那么combobox的初始值就干脆不在资源编辑器里设置,而是独立成一条字符串放到string table里,用的时候从资源里读取出来,自己拆解后插入combobox。

特点:

  1. 不能利用资源编辑器所见即所得的便利,combobox的大小不好控制。
  2. 每个combobox都要这么搞,实在太麻烦。

所以虽然这种方法在网上很流行,不少支持NUI的软件都这么玩,但我还是不想这么干。

方案二:原创,根本性解决问题

  1. 参照ExecuteDlgInit的代码写一段combobox初始化代码,先把DLGINIT中的初始字符串从ANSI转换成Unicode后,再调用SendDlgItemMessageW插入comobobox。
  2. 写一个通用的对话框初始化函数,先周游对话框下的所有控件,删掉已经初始化过的combobox中的内容,再用上面的代码对combobox重新初始化。
  3. 在每一个对话框、PropertyPage的OnInitDialog()函数中,在调用完基类的OnInitDialog()函数后,调用上面这个初始化函数对combobox进行初始化。

与方案一相比,方案二显然简单得多,且能够使用资源编辑器设置combobox的初始化data,所以我用的就是这个方案。

二、消息框(MessageBox)的按钮文字没有按照设定语言显示文字的原因及解决方案

原因分析:

查了一下Windows XP的源代码,对消息框是这样实现的:

int MessageBoxW(
    HWND hwndOwner,
    LPCWSTR lpszText,
    LPCWSTR lpszCaption,
    UINT wStyle)
{
    EMIGETRETURNADDRESS();
    return MessageBoxExW(hwndOwner, lpszText, lpszCaption, wStyle, 0);
}

int MessageBoxExW(
    HWND hwndOwner,
    LPCWSTR lpszText,
    LPCWSTR lpszCaption,
    UINT wStyle,
    WORD wLanguageId)
{
    return MessageBoxTimeoutW(hwndOwner,
                  lpszText,
                  lpszCaption,
                  wStyle,
                  wLanguageId,
                  INFINITE);
}	

为保险起见,反编译了win10下的user32.dll做对照,发现win0果然有所长进,没有采用这种俄罗斯套娃式的低效代码,而是在MessageBoxW函数中直接:
return MessageBoxTimeoutW(hwndOwner, lpszText, lpszCaption, wStyle, 0, INFINITE);

同样win10下的MessageBoxExW,也是直接:
return MessageBoxTimeoutW(hwndOwner, lpszText, lpszCaption, wStyle, wLanguageId, INFINITE);

即不论XP还是Win10,调用MessageBox,均相当于用MAKELANGID(LANG_NEUTRAL, SUBLANG_NEUTRAL)参数调用MessageBoxEx。所以网上有些传言说不应该用MessageBox,而应该用MessageBoxEx,其实是不对的,因为源代码和反编译代码都说明二者等价。

本来按照MSDN对MessageBoxEx函数的说法,用MAKELANGID(LANG_NEUTRAL, SUBLANG_NEUTRAL)参数调用MessageBoxEx,应该按照当前线程所设置的语言显示按钮文字,这些文字存放在对应语言文件夹下的user32.dll.mui文件的资源中。

但问题在于简体中文Windows下有en-US\user32.dll.mui,但原版英文Windows下却没有zh-CN\user32.dll.mui。所以设置为英语后,在简体中文Windows下消息框按钮显示为OK,但设置为简体中文后,在英文Windows下消息框按钮仍然是OK而不是“确定”,除非在英文版Windows下已经安装过中文语言包。

解决办法可以有多种:

  1. 要求用户安装微软发行的Windows简体中文语言包,这是最简单、最正宗的方法。
  2. 如果不能,用户要求也不高,要不就这么算了吧,因为按照Windows缺省语言显示的按钮文字,用户肯定看得懂,所以虽然影响观瞻,但不影响使用。
  3. 如果要求比较高,可以参考wine或Windows XP源代码中的MessageBox实现代码,自己写一个,对11个按钮想按照什么语言、文字SetWindowText都可以。wine的源代码简单一些,没有声音、没有copy功能,消息框的对话框模板也在rc文件中定义。Windows源代码的实现水平要更高一些,消息框的对话框模板都不屑于在资源中定义,而是按需在内存中动态生成,我初见的时候也懵了一下,感觉如果真能看懂,编程水平都要涨一截。
  4. 如果想简单点,就用SetWindowsHookEx装一个消息钩子(WH_CALLWNDPROC),对WM_INITDIALOG消息进行监视,发现初始化的是消息框,就查找按钮并重置按钮的文字。

在消息钩子中判断消息框的依据:

  1. window style含DS_ABSALIGN、DS_NOIDLEMSG。一般其他对话框很少含这两个style。
  2. 如果调用的是AfxMessageBox,而不是直接调用::MessageBox,则除了MB_ABORTRETRYIGNORE、MB_RETRYCANCEL风格之外的消息框都会带一个icon,这个icon的ID是20,style含SS_ICON,ClassName是Static。以上这些通过Spy++都能看到。

三、PropertySheet按钮文字不按照设定语言显示的原因与解决方案

原因很简单,没有相应的语言包,即mui文件。所以最简单的办法还是安装语言包,如果实在不想或不能安装,再考虑下面的解决方法。

做产品式的解决方法:

  1. 从CPropertySheet派生出一个类来,重载OnInitDialog(),在其中对标准按钮(IDOK、IDCANCEL、ID_APPLY_NOW、IDHELP)的文字,按照选定语言用SetWindowText进行设置。
  2. 缺省情况下CPropertySheet、CPropertyPage不管资源编辑器中选择了什么字体、字号,一律按系统设定的字体、字号显示,令人不爽,正好在派生类中一并解决了。我的DjVuToy、TiffToy等软件就是这么玩的。

如果采用这种方案,CPrintDialogEx也要进行派生,然后重载DefWindowProc()函数,在其中处理WM_INITDIALOG函数,对按钮文字进行设置。

做项目式的解决方法:

用SetWindowsHookEx装一个消息钩子(WH_CALLWNDPROC),对WM_INITDIALOG消息进行监视,发现是PropertySheet,就查找按钮并重置按钮的文字。判断PropertySheet的依据:

  1. 自身的ClassName是"#32770"。
  2. 含SysTabControl32控件。
  3. 含4个按钮:
    const static int IDs[] = {IDOK, IDCANCEL, IDD_APPLYNOW, IDHELP};

用这种方法,顺便也解决了CPrintDialogEx的按钮问题,因为CPrintDialogEx的主窗口本来就是一个PropertySheet。

四、SHBrowseForFolder按钮和提示文字不按照设定语言显示的原因与解决方案

原因和上面一样,没有相应的语言包。所以只有实在不想或不能安装语言包,再考虑下面的解决方法。

做产品式的解决方法:

  1. 把BROWSEINFO结构体的lpfn指针指向一个自定义的消息处理函数。
  2. 在该消息处理函数中,收到BFFM_INITIALIZED消息后,自己设置标题、按钮、提示。其中对于IDD_FOLDERLABLE要注意检查是否有足够的空间显示全部文字,否则可能会自动折行。
  3. 缺省SHBrowseForFolder显示的对话框尺寸太小,在处理BFFM_INITIALIZED消息时顺便可以扩展一下对话框。

SHBrowseForFolder的完整源代码在Windows 2000、XP、2003的源代码中都可以找到,对话框中的ID自然也在里面。我写的Pdg2Pic等软件就是这么玩的,所以选择文件夹的对话框看起来比别家的要大气一点。

做项目式的解决方法:

  1. 用SetWindowsHookEx装一个消息钩子(WH_CALLWNDPROC),对WM_PARENTNOTIFY消息进行监视,发现是SHBrowseForFolder,就查找按钮并重置按钮的文字。
  2. 判断SHBrowseForFolder的依据:含有ClassName是"SHBrowseForFolder ShellNameSpace Control"的控件。

五、部分关键源代码及测试实例

上面二、三、四部分如果都用消息钩子实现,则其钩子相关函数如下:

HHOOK	g_hMsgHook4MUI = NULL;

static LRESULT CALLBACK CallMsgWndProc( int nCode, WPARAM wParam, LPARAM lParam )
{
	// 先调用原始的消息处理函数,处理WM_INITDIALOG等消息
	LRESULT ret = CallNextHookEx(g_hMsgHook4MUI, nCode, wParam, lParam);

	CWPSTRUCT* pStruc = (CWPSTRUCT*)lParam;
	if (wParam == 0)
	{
		if (pStruc->message == WM_INITDIALOG)
		{
			if (IsMsgBox(pStruc->hwnd))
				FixMsgBoxButtons(pStruc->hwnd);
			else if (IsPropertySheet(pStruc->hwnd))
				FixPropertySheet(pStruc->hwnd);
		}
		else if (pStruc->message == WM_PARENTNOTIFY && pStruc->wParam == BFFM_INITIALIZED)
		{
			if (IsSHBrowseForFolder(pStruc->hwnd))
				FixSHBrowseForFolder(pStruc->hwnd);
		}
	}

	return ret;
}

void InstallMsgHook4MUI()
{
	g_hMsgHook4MUI = SetWindowsHookEx(WH_CALLWNDPROC, CallMsgWndProc, NULL, ::GetCurrentThreadId());
}

void UnInstallMsgHook4MUI()
{
	if ( g_hMsgHook4MUI != NULL )
	{
		if ( UnhookWindowsHookEx( g_hMsgHook4MUI ) != 0 )
			g_hMsgHook4MUI = NULL;
	}
}	

然后在App的InitInstance(),或主对话框的OnInitDialog()里,调用InstallMsgHook4MUI()安装钩子;在App的ExitInstance(),或主对话框的OnDestroy()里调用UnInstallMsgHook4MUI()取消钩子。

当然在App的InitInstance()函数里,别忘了调用
SetThreadUILanguage(MAKELANGID(LANG_CHINESE, SUBLANG_CHINESE_SIMPLIFIED));
对语言进行设置。

按照上面说明实现的一个测试例子见下面链接,在未安装简体中文的Windows环境下,运行后各对话框文字、按钮仍然能显示简体中文。

链接:https://pan.baidu.com/s/11irniZke-hUgvDpim1knSA
提取码:uvk0

你可能感兴趣的:(MFC软件国际化的几个问题及其解决方案)