title: MFC基于对话框使用dll进行多语言切换
categories:[MFC]
tags:[音视频编程]
date: 2021/12/15
作者：hackett
微信公众号：加班猿
一、前言
Qt使用qm文件切换有两种加载方式，比较容易一些
在资源文件中加载(这个比较好)： 优点：
- 在程序发布时不用把最新的.qm文件拷贝到加载路径中，降低了修改翻译时界面没有翻译或翻译不准确的风险；
- 不会把翻译的信息暴露给用户；
缺点：
- 资源文件会编译时可执行程序，所以会导致可执行程序的体积变大(但是.qm文件一般很小，这个缺点可以忽略不计)；
- 当只修改翻译不修改源码时也必须重新编译可执行程序。
在程序外部加载：
优点：
扫描二维码关注公众号，回复：
13620298 查看本文章
- 当只修改翻译不修改源码时不用重新编译可执行程序，只要替换修改后的.qm文件；
- 不会影响可执行程序的大小；
缺点：
- 程序发布时，要把最新.qm文件中复制到相应加载路径下(在实际开发中经常会忘了这个步骤)，导致没有翻译或翻译不准确；
- 把翻译信息暴露给用户，可能会被用户修改(不可抗因素，可以忽略)。
有个需求MFC界面需要做一个多语言切换，百度了一番，MFC实现多国语言有不少方法：
- VS提供对话框的“插入副本”方法；
- 将要显示的界面文字做一个类似ini文件，加载界面的时候各控件用SetWindowText来显示不同的语言内容；
- 制作Dll资源文件，不同语言调用不同的Dll；
综合下来dll方式比较适合自己的需求，就使用这个来做
二、准备工作
visual studio中新建一个MFC项目
【文件】——【新建】——【项目】，选择“MFC 应用程序”，项目名称：test，放在workspace文件夹里
选择“基于对话框”，取消“使用 Unicode 库”
【完成】完成对基于对话框MFC项目的创建。
界面随便来两个按钮跟text、Edit Control
右键【添加资源】——【Menu】——【新建】 ，建一个menu来进行语言的选择，添加语言切换选项
打开test.rc的属性，找到【杂项】的Menu中选中刚刚的IDR_MENU1，做好这些就可以准备dll的制作了
三、制作dll
创建英文版的dll
visual studio中
解决方案右键 【添加】——【新建项目】 选择MFC DLL，输入项目名English，确定
MFC DLL向导不做修改，采用默认的共享MFC DLL规则设置，【完成】。
删除DLL中不需要的文件
移除工程的“资源文件”下的English.rc,English.rc2文件，“头文件”下的Resource.h文件，并到对应目录将其删除
导入相关文件：
将workspace\test下的“test.rc”、“resource.h”复制到英文DLL项目的文件夹test\English下。
然后将test的workspace\test\res文件夹中的文件全部复制到英文DLL项目对应的文件夹下。
再将上述文件添加到 English 项目中。
右击English项目，【添加】——【现有项】，如图所示
修改English项目的相关资源属性为英语，并将对应的button和text翻译成英文
修改English项目属性。【配置属性】——【链接器】——【高级】，“无入口点”改为“是（/NOENTRY）”。
接下来就可以右键【生成】生成English.dll
按English项目的方法可创建中文、日语、其他语言版本。
文本框中的显示内容也可以采用从配置文件读取，方式跟读取语言配置的一样操作
test.h
// test.h : PROJECT_NAME 应用程序的主头文件
//
#pragma once
#ifndef __AFXWIN_H__
#error "在包含此文件之前包含“stdafx.h”以生成 PCH 文件"
#endif
#include "resource.h" // 主符号
// CtestApp:
// 有关此类的实现，请参阅 test.cpp
//
class CtestApp : public CWinApp
{
public:
CtestApp();
// 重写
public:
virtual BOOL InitInstance();
// 新添加代码
private:
CString pExePath;
char m_strLanguage[MAX_PATH];
HINSTANCE m_hLangDLL;
// 实现
DECLARE_MESSAGE_MAP()
};
extern CtestApp theApp;
复制代码test.cpp
// test.cpp : 定义应用程序的类行为。
//
#include "stdafx.h"
#include "test.h"
#include "testDlg.h"
#ifdef _DEBUG
#define new DEBUG_NEW
#endif
// CtestApp
BEGIN_MESSAGE_MAP(CtestApp, CWinApp)
ON_COMMAND(ID_HELP, &CWinApp::OnHelp)
END_MESSAGE_MAP()
// CtestApp 构造
CtestApp::CtestApp()
{
// 支持重新启动管理器
m_dwRestartManagerSupportFlags = AFX_RESTART_MANAGER_SUPPORT_RESTART;
// TODO: 在此处添加构造代码，
// 将所有重要的初始化放置在 InitInstance 中
// 新增代码
// 初始化变量
memset(m_strLanguage,0,sizeof(m_strLanguage));
m_hLangDLL=NULL;
}
// 唯一的一个 CtestApp 对象
CtestApp theApp;
BOOL CtestApp::InitInstance()
{
// 如果一个运行在 Windows XP 上的应用程序清单指定要
// 使用 ComCtl32.dll 版本 6 或更高版本来启用可视化方式，
//则需要 InitCommonControlsEx()。否则，将无法创建窗口。
INITCOMMONCONTROLSEX InitCtrls;
InitCtrls.dwSize = sizeof(InitCtrls);
// 将它设置为包括所有要在应用程序中使用的
// 公共控件类。
InitCtrls.dwICC = ICC_WIN95_CLASSES;
InitCommonControlsEx(&InitCtrls);
CWinApp::InitInstance();
AfxEnableControlContainer();
// 创建 shell 管理器，以防对话框包含
// 任何 shell 树视图控件或 shell 列表视图控件。
CShellManager *pShellManager = new CShellManager;
// 标准初始化
// 如果未使用这些功能并希望减小
// 最终可执行文件的大小，则应移除下列
// 不需要的特定初始化例程
// 更改用于存储设置的注册表项
// TODO: 应适当修改该字符串，
// 例如修改为公司或组织名
SetRegistryKey(_T("应用程序向导生成的本地应用程序"));
// ***********新增代码。语言选择 **********
// 读取 INI 文件中的设置
pExePath = CtestDlg::GetExePath();
pExePath += _T("\ip.ini");
::GetPrivateProfileString(_T("Language"), _T("currentlanguage"), _T(""),m_strLanguage, MAX_PATH, pExePath);
// 加载对应的 DLL 文件
switch (atoi(m_strLanguage))
{
case LANG_CHINESE:
m_hLangDLL=::LoadLibrary("Chinese.dll");
break;
case LANG_ENGLISH:
m_hLangDLL=::LoadLibrary("English.dll");
break;
default:
m_hLangDLL=::LoadLibrary("Chinese.dll");
break;
}
if (m_hLangDLL!=NULL)
{
AfxSetResourceHandle(m_hLangDLL);
}
else
{
AfxMessageBox("语言DLL文件加载失败！");
exit(1); // 非正常终止程序
}
// ***************************************
CtestDlg dlg;
m_pMainWnd = &dlg;
INT_PTR nResponse = dlg.DoModal();
if (nResponse == IDOK)
{
// TODO: 在此放置处理何时用
// “确定”来关闭对话框的代码
}
else if (nResponse == IDCANCEL)
{
// TODO: 在此放置处理何时用
// “取消”来关闭对话框的代码
}
else if (nResponse == -1)
{
TRACE(traceAppMsg, 0, "警告: 对话框创建失败,应用程序将意外终止，如果您在对话框上使用 MFC 控件，则无法 #define _AFX_NO_MFC_CONTROLS_IN_DIALOGS。\n");
}
// 删除上面创建的 shell 管理器。
if (pShellManager != NULL)
{
delete pShellManager;
}
// 由于对话框已关闭，所以将返回 FALSE 以便退出应用程序，
// 而不是启动应用程序的消息泵。
return FALSE;
}
复制代码testDlg.cpp
// testDlg.cpp : 实现文件
//
#include "stdafx.h"
#include "test.h"
#include "testDlg.h"
#include "afxdialogex.h"
#ifdef _DEBUG
#define new DEBUG_NEW
#endif
// 用于应用程序“关于”菜单项的 CAboutDlg 对话框
class CAboutDlg : public CDialogEx
{
public:
CAboutDlg();
// 对话框数据
enum { IDD = IDD_ABOUTBOX };
protected:
virtual void DoDataExchange(CDataExchange* pDX); // DDX/DDV 支持
// 实现
protected:
DECLARE_MESSAGE_MAP()
};
CAboutDlg::CAboutDlg() : CDialogEx(CAboutDlg::IDD)
{
}
void CAboutDlg::DoDataExchange(CDataExchange* pDX)
{
CDialogEx::DoDataExchange(pDX);
}
BEGIN_MESSAGE_MAP(CAboutDlg, CDialogEx)
END_MESSAGE_MAP()
// CtestDlg 对话框
CtestDlg::CtestDlg(CWnd* pParent /*=NULL*/)
: CDialogEx(CtestDlg::IDD, pParent)
{
m_hIcon = AfxGetApp()->LoadIcon(IDR_MAINFRAME);
// 初始化变量
m_hLangDLL=NULL;
}
void CtestDlg::DoDataExchange(CDataExchange* pDX)
{
CDialogEx::DoDataExchange(pDX);
}
BEGIN_MESSAGE_MAP(CtestDlg, CDialogEx)
ON_WM_SYSCOMMAND()
ON_WM_PAINT()
ON_WM_QUERYDRAGICON()
ON_BN_CLICKED(IDC_BUTTON1, &CtestDlg::OnBnClickedButton1)
ON_COMMAND(ID_MENU_CHINESE, &CtestDlg::OnChinese)
ON_COMMAND(ID_MENU_ENGLISH, &CtestDlg::OnEnglish)
END_MESSAGE_MAP()
// CtestDlg 消息处理程序
BOOL CtestDlg::OnInitDialog()
{
CDialogEx::OnInitDialog();
// 将“关于...”菜单项添加到系统菜单中。
// IDM_ABOUTBOX 必须在系统命令范围内。
ASSERT((IDM_ABOUTBOX & 0xFFF0) == IDM_ABOUTBOX);
ASSERT(IDM_ABOUTBOX < 0xF000);
CMenu* pSysMenu = GetSystemMenu(FALSE);
if (pSysMenu != NULL)
{
BOOL bNameValid;
CString strAboutMenu;
bNameValid = strAboutMenu.LoadString(IDS_ABOUTBOX);
ASSERT(bNameValid);
if (!strAboutMenu.IsEmpty())
{
pSysMenu->AppendMenu(MF_SEPARATOR);
pSysMenu->AppendMenu(MF_STRING, IDM_ABOUTBOX, strAboutMenu);
}
}
// 设置此对话框的图标。当应用程序主窗口不是对话框时，框架将自动
// 执行此操作
SetIcon(m_hIcon, TRUE); // 设置大图标
SetIcon(m_hIcon, FALSE); // 设置小图标
// TODO: 在此添加额外的初始化代码
m_menu.LoadMenu(IDR_MENU1); // 注意这里需要加载menu
SetMenu(&m_menu);
return TRUE; // 除非将焦点设置到控件，否则返回 TRUE
}
void CtestDlg::OnSysCommand(UINT nID, LPARAM lParam)
{
if ((nID & 0xFFF0) == IDM_ABOUTBOX)
{
CAboutDlg dlgAbout;
dlgAbout.DoModal();
}
else
{
CDialogEx::OnSysCommand(nID, lParam);
}
}
// 如果向对话框添加最小化按钮，则需要下面的代码
// 来绘制该图标。对于使用文档/视图模型的 MFC 应用程序，
// 这将由框架自动完成。
void CtestDlg::OnPaint()
{
if (IsIconic())
{
CPaintDC dc(this); // 用于绘制的设备上下文
SendMessage(WM_ICONERASEBKGND, reinterpret_cast<WPARAM>(dc.GetSafeHdc()), 0);
// 使图标在工作区矩形中居中
int cxIcon = GetSystemMetrics(SM_CXICON);
int cyIcon = GetSystemMetrics(SM_CYICON);
CRect rect;
GetClientRect(&rect);
int x = (rect.Width() - cxIcon + 1) / 2;
int y = (rect.Height() - cyIcon + 1) / 2;
// 绘制图标
dc.DrawIcon(x, y, m_hIcon);
}
else
{
CDialogEx::OnPaint();
}
}
//当用户拖动最小化窗口时系统调用此函数取得光标
//显示。
HCURSOR CtestDlg::OnQueryDragIcon()
{
return static_cast<HCURSOR>(m_hIcon);
}
CString CtestDlg::GetExePath() {
char szExePath[MAX_PATH] = {0};
GetModuleFileName(AfxGetApp()->m_hInstance, szExePath, 256);
int i = (int)strlen(szExePath) - 1;
for (; i >= 0 && szExePath[i] != '\'; i--)
;
szExePath[i + 1] = 0;
return szExePath;
}
void CtestDlg::OnBnClickedButton1()
{
}
BOOL CtestDlg::ResetDialog()
{
//TODO: 处理可能已添加的附加资源
AfxOleTerm(FALSE);
if(m_hLangDLL)
{
FreeLibrary(m_hLangDLL);
}
STARTUPINFO StartupInfo={0};
PROCESS_INFORMATION ProcessInfo;
StartupInfo.cb=sizeof(STARTUPINFO);
char Path[256];
GetModuleFileName(NULL,(LPSTR)(LPCTSTR)Path,250);
CreateProcess(NULL,(LPSTR)(LPCTSTR)Path,NULL,NULL,FALSE,0,NULL,NULL,&StartupInfo,&ProcessInfo);
return TRUE;
}
void CtestDlg::OnChinese()
{
// TODO: 在此添加命令处理程序代码
pExePath = GetExePath();
pExePath += _T("\ip.ini");
int iRet = MessageBox(_T("Make sure to switch to the Chinese version?"),_T("Tips"),MB_YESNO);
if (iRet == IDYES) {
WritePrivateProfileString(_T("Language"), _T("currentlanguage"), "0", pExePath);
m_hLangDLL=::LoadLibrary("Chinese.dll");
if (m_hLangDLL!=NULL)
{
ResetDialog();
AfxSetResourceHandle(m_hLangDLL);
exit(1);
}
else
{
AfxMessageBox("语言Chinese.dll文件加载失败！");
exit(1); // 非正常终止程序
}
}
}
void CtestDlg::OnEnglish()
{
// TODO: 在此添加命令处理程序代码
pExePath = GetExePath();
pExePath += _T("\Config.ini");
int iRet = MessageBox(_T("确定切换到英文版本?"),_T("提示"),MB_YESNO);
if (iRet == IDYES) {
WritePrivateProfileString(_T("Language"), _T("currentlanguage"), "1", pExePath);
m_hLangDLL=::LoadLibrary("English.dll");
if (m_hLangDLL!=NULL)
{
ResetDialog();
AfxSetResourceHandle(m_hLangDLL);
exit(1);
}
else
{
AfxMessageBox("语言English.dll文件加载失败！");
exit(1); //非正常终止程序
}
}
}
复制代码testDlg.h
// testDlg.h : 头文件
//
#pragma once
// 添加宏定义
#define LANG_CHINESE 0
#define LANG_ENGLISH 1
#define LANG_JAPNESE 2
// CtestDlg 对话框
class CtestDlg : public CDialogEx
{
// 构造
public:
CtestDlg(CWnd* pParent = NULL); // 标准构造函数
// 对话框数据
enum { IDD = IDD_TEST_DIALOG };
protected:
virtual void DoDataExchange(CDataExchange* pDX); // DDX/DDV 支持
// 实现
protected:
HICON m_hIcon;
// 生成的消息映射函数
virtual BOOL OnInitDialog();
virtual BOOL ResetDialog();
afx_msg void OnSysCommand(UINT nID, LPARAM lParam);
afx_msg void OnPaint();
afx_msg HCURSOR OnQueryDragIcon();
DECLARE_MESSAGE_MAP()
public:
afx_msg void OnBnClickedButton1();
afx_msg void OnChinese();
afx_msg void OnEnglish();
static CString GetExePath();
CString pExePath;
HINSTANCE m_hLangDLL;
CMenu m_menu;
};
复制代码ip.ini
[Language]
currentlanguage=0
复制代码四、遇到的坑
1、用dll进行多语言切换的时候不要用 MFC Button Control类型的button，用普通的button（不然程序运行会一闪而过）
最后来张效果图：
如果你觉得文章还不错，可以给个"三连"，文章同步到个人微信公众号[加班猿]
我是hackett，我们下期见