title: MFC基於對話方塊使用dll進行多語言切換

categories:[MFC]

tags:[音視訊程式設計]

date: 2021/12/15

一、前言

Qt使用qm檔案切換有兩種載入方式，比較容易一些

在資原始檔中載入(這個比較好)：
優點：

• 在程式釋出時不用把最新的.qm檔案拷貝到載入路徑中，降低了修改翻譯時介面沒有翻譯或翻譯不準確的風險；

• 不會把翻譯的資訊暴露給使用者；

缺點：

• 資原始檔會編譯時可執行程式，所以會導致可執行程式的體積變大(但是.qm檔案一般很小，這個缺點可以忽略不計)；

• 當只修改翻譯不修改原始碼時也必須重新編譯可執行程式。

在程式外部載入：

優點：

• 當只修改翻譯不修改原始碼時不用重新編譯可執行程式，只要替換修改後的.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，我們下期見