MFC基于对话框使用dll进行多语言切换

2024-01-05 14:19:10

title: MFC基于对话框使用dll进行多语言切换

categories:[MFC]

tags:[音视频编程]

date: 2021/12/15

作者：hackett 微信公众号：加班猿

一、前言

Qt使用qm文件切换有两种加载方式，比较容易一些

在资源文件中加载(这个比较好)：
优点：

  • 在程序发布时不用把最新的.qm文件拷贝到加载路径中，降低了修改翻译时界面没有翻译或翻译不准确的风险；

  • 不会把翻译的信息暴露给用户；

缺点：

  • 资源文件会编译时可执行程序，所以会导致可执行程序的体积变大(但是.qm文件一般很小，这个缺点可以忽略不计)；

  • 当只修改翻译不修改源码时也必须重新编译可执行程序。

在程序外部加载：

优点：

  • 当只修改翻译不修改源码时不用重新编译可执行程序，只要替换修改后的.qm文件；

  • 不会影响可执行程序的大小；

缺点：

  • 程序发布时，要把最新.qm文件中复制到相应加载路径下(在实际开发中经常会忘了这个步骤)，导致没有翻译或翻译不准确；

  • 把翻译信息暴露给用户，可能会被用户修改(不可抗因素，可以忽略)。

有个需求MFC界面需要做一个多语言切换，百度了一番，MFC实现多国语言有不少方法：

  • VS提供对话框的“插入副本”方法；
  • 将要显示的界面文字做一个类似ini文件，加载界面的时候各控件用SetWindowText来显示不同的语言内容；
  • 制作Dll资源文件，不同语言调用不同的Dll；

综合下来dll方式比较适合自己的需求，就使用这个来做

二、准备工作

visual studio中新建一个MFC项目

【文件】——【新建】——【项目】，选择“MFC 应用程序”，项目名称：test，放在workspace文件夹里

选择“基于对话框”，取消“使用 Unicode 库”

【完成】完成对基于对话框MFC项目的创建。

MFC基于对话框使用dll进行多语言切换

界面随便来两个按钮跟text、Edit Control

MFC基于对话框使用dll进行多语言切换

右键【添加资源】——【Menu】——【新建】 ，建一个menu来进行语言的选择，添加语言切换选项

MFC基于对话框使用dll进行多语言切换

打开test.rc的属性，找到【杂项】的Menu中选中刚刚的IDR_MENU1，做好这些就可以准备dll的制作了

三、制作dll

创建英文版的dll

visual studio中

解决方案右键 【添加】——【新建项目】 选择MFC DLL，输入项目名English，确定

MFC DLL向导不做修改，采用默认的共享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项目，【添加】——【现有项】，如图所示

MFC基于对话框使用dll进行多语言切换

修改English项目的相关资源属性为英语，并将对应的button和text翻译成英文

MFC基于对话框使用dll进行多语言切换

修改English项目属性。【配置属性】——【链接器】——【高级】，“无入口点”改为“是（/NOENTRY）”。

MFC基于对话框使用dll进行多语言切换

接下来就可以右键【生成】生成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（不然程序运行会一闪而过）

最后来张效果图：

MFC基于对话框使用dll进行多语言切换

如果你觉得文章还不错，可以给个"三连"，文章同步到个人微信公众号[加班猿]

我是hackett，我们下期见

上一篇：C# 调用C++动态链接库Dll以及联调(转)


下一篇：hal.dll丢失系统无法启动-hal.dll丢失解决步骤