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

categories:[MFC]

tags:[音视频编程]

date: 2021/12/15

<div align = 'right'>作者：hackett</div>

<div align = 'right'>微信公众号：加班猿</div>

一、前言

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

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

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

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

缺点：

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

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

在程序外部加载：

优点：

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

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

缺点：

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

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

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

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

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

二、准备工作

visual studio中新建一个MFC项目

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

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

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

image

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

image

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

image

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

三、制作dll

创建英文版的dll

visual studio中

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

MFC DLL向导不做修改，采用默认的共享MFC DLL规则设置，【完成】。

image

删除DLL中不需要的文件

移除工程的“资源文件”下的English.rc,English.rc2文件，“头文件”下的Resource.h文件，并到对应目录将其删除

导入相关文件：

将workspace\test下的“test.rc”、“resource.h”复制到英文DLL项目的文件夹test\English下。

然后将test的workspace\test\res文件夹中的文件全部复制到英文DLL项目对应的文件夹下。

再将上述文件添加到 English 项目中。

右击English项目，【添加】——【现有项】，如图所示

image

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

image

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

image

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

最后来张效果图：

image

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

我是hackett，我们下期见