CLanguageSupport.h

Go to the documentation of this file.

/*--------------------------------------------------------------------------------------+
|
|   Supplied under applicable software license agreement.
|
|   Copyright (c) 2018 Bentley Systems, Incorporated. All rights reserved.
|
+---------------------------------------------------------------------------------------*/
#pragma once

//
//  CLanguageSupport : Language selection support and resource DLLs management for MFC.
//
//  Portions copied from:
//  Author : Serge Wautier.
//  Source : Code project article (http://www.codeproject.com/cpp/LanguageMenu.asp)
//

// To use CLanguageSupport, link with nativewindow.lib.

#include <afxcoll.h>

#if !defined (DLLEXPORT)
#define DLLEXPORT __declspec( dllexport )
#endif
//
//  CLanguageSupport : Language selection support and resource DLLs management for MFC.
//
//  Portions copied from:
//  Author : Serge Wautier.
//  Source : Code project article (http://www.codeproject.com/cpp/LanguageMenu.asp)
//      @remark                Required Library: nativewindow.lib
// To use CLanguageSupport, link with nativewindow.lib.


class CLanguageSupport
    {
    public:
        DLLEXPORT CLanguageSupport ();
        DLLEXPORT ~CLanguageSupport ();

        DLLEXPORT void SetCurrentModule (HMODULE hModule);
        DLLEXPORT void SetAbbrevNameFromLanguage (LPCTSTR language);
        DLLEXPORT void SetDefaultAbbrevName (LPCTSTR abbrevName);
        DLLEXPORT void LoadBestLanguage (); // Called on start-up to load the required language dll

    protected:
        LANGID          m_nModuleLanguage;
        LANGID          m_nCurrentLanguage;
        CString         m_defaultAbbrevName;
        HMODULE         m_currentModule;

        HINSTANCE       m_hDll; // Satellite DLL.

        static LANGID GetLangIdFromFile (LPCTSTR pszFilename);
        static CString GetLanguageName (LANGID wLangId);

        static LANGID GetUserUILanguage ();
        static LANGID GetSystemUILanguage ();

        bool LoadLanguage (); // Try to load the language m_nCurrentLanguage.
        // If it doesn't exist, try to fallback on the neutral or default sublanguage for this language.

        bool LoadLanguageDll (); // Identifies and loads the resource DLL for language m_nCurrentLanguage
        bool LoadLanguageDllFromAbbrevName (LPCTSTR szAbbrevName);

        void LookupModuleLanguage (); // Initializes m_nModuleLanguage with the original language of the app (stored in the exe)

        void UnloadResourceDll (); // Unloads the current resource DLL (if any)

        static void SetResourceHandle (HINSTANCE hDll); // Tells MFC where the resources are stored.
    };