Mendukung Pengaturan Bahasa Application-Specific

Aplikasi Anda dapat mendukung serangkaian bahasa antarmuka pengguna yang berbeda dari yang didukung oleh sistem operasi target. Topik ini membahas jenis dukungan ini, menggunakan cuplikan dari sampel lengkap.

Menginterpretasikan Preferensi Bahasa Pengguna

Aplikasi Anda harus terlebih dahulu menentukan bahasa antarmuka pengguna mana yang akan ditampilkan, berdasarkan preferensi pengguna. Kode dapat membaca pengaturan dari file konfigurasi atau dari pengaturan registri.

Contoh berikut mendefinisikan dua fungsi yang digunakan untuk menginterpretasikan preferensi bahasa pengguna. Fungsi pertama mengilustrasikan pembacaan daftar bahasa yang dibatasi dari file, yang diwakili dalam kode sebagai "langs.txt". Pemisah yang didukung dalam contoh adalah ",", ";", ".", dan " ". Fungsi kedua mengonversi string yang dibaca dari file menjadi nilai multi-string. Operasi ini diperlukan karena fungsi MUI yang digunakan untuk mengatur bahasa hanya menerima nilai multi-string.

BOOL GetMyUserDefinedLanguages(WCHAR * langStr, DWORD langStrSize)
{
    BOOL rtnVal = FALSE;
    // Very simple implementation - assumes that first 'langStrSize' characters of the
    // L".\\langs.txt" file comprises a string of one or more languages.
    HANDLE langConfigFileHandle = CreateFileW(L".\\langs.txt", GENERIC_READ, 0,
                                    NULL, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, NULL);
    if(langConfigFileHandle != INVALID_HANDLE_VALUE)
    {
        // Clear the input variables.
        DWORD bytesActuallyRead = 0;
        if(ReadFile(langConfigFileHandle, langStr, langStrSize*sizeof(WCHAR), &bytesActuallyRead, NULL)
           && bytesActuallyRead > 0)
        {
            rtnVal = TRUE;
            DWORD nullIndex = (bytesActuallyRead/sizeof(WCHAR) < langStrSize)
                              ? bytesActuallyRead/sizeof(WCHAR) : langStrSize;
            langStr[nullIndex] = L'\0';
        }
        CloseHandle(langConfigFileHandle);
    }
    return rtnVal;
}
BOOL ConvertMyLangStrToMultiLangStr(WCHAR * langStr, WCHAR * langMultiStr, DWORD langMultiStrSize)
{
    BOOL rtnVal = FALSE;
    size_t strLen = 0;
    rtnVal = SUCCEEDED(StringCchLengthW(langStr, USER_CONFIGURATION_STRING_BUFFER*2, &strLen));
    if(rtnVal && strLen > 0 && langMultiStr && langMultiStrSize > 0)
    {
        WCHAR * langMultiStrPtr = langMultiStr;
        WCHAR * last = langStr + (langStr[0] == 0xFEFF ? 1 : 0);
        WCHAR * context = last;
        WCHAR * next = wcstok_s(last,L",; :",&context);
        while(next && rtnVal)
        {
            // Make sure you validate the user input.
            if(SUCCEEDED(StringCchLengthW(last, LOCALE_NAME_MAX_LENGTH, &strLen))
               && IsValidLocaleName(next))
            {
                langMultiStrPtr[0] = L'\0';
                rtnVal &= SUCCEEDED(StringCchCatW(langMultiStrPtr,
                                    (langMultiStrSize - (langMultiStrPtr - langMultiStr)), next));
                langMultiStrPtr += strLen + 1;
            }
            next = wcstok_s(NULL, L",; :", &context);
            if(next)
                last = next;
        }
        // Make sure there is a double null term for the multi-string.
        if(rtnVal && (langMultiStrSize - (langMultiStrPtr - langMultiStr)))
        {
            langMultiStrPtr[0] = L'\0';
        }
        else // Fail and guard anyone whom might use the multi-string.
        {
            langMultiStr[0] = L'\0';
            langMultiStr[1] = L'\0';
        }
    }
    return rtnVal;
}

Mengatur Bahasa Aplikasi

Setelah membaca informasi preferensi bahasa, kode aplikasi harus menggunakan pengaturan yang diambil untuk mengatur bahasa aplikasi. Pada Windows 7 dan yang lebih baru, aplikasi dapat mengatur bahasa di tingkat proses dengan memanggil fungsiSetProcessPreferredUILanguages.

DWORD langCount = 0;
// Using SetProcessPreferredUILanguages is recommended for new applications (esp. multi-threaded applications).
if(!SetProcessPreferredUILanguages(MUI_LANGUAGE_NAME, userLanguagesMultiString, &langCount) || langCount == 0)
{
    swprintf_s(displayBuffer, SUFFICIENTLY_LARGE_ERROR_BUFFER,
               L"FAILURE: Unable to set the user defined languages, last error = %d.", GetLastError());
    MessageBoxW(NULL, displayBuffer, L"HelloMUI ERROR!", MB_OK | MB_ICONERROR);
    return 1; // Exit.
}

Pada Windows Vista dan yang lebih baru, bahasa aplikasi diatur pada tingkat utas dengan memanggil fungsiSetThreadPreferredUILanguages.

DWORD langCount = 0;
// The following line of code is supported on Windows Vista and later.
if(!SetThreadPreferredUILanguages(MUI_LANGUAGE_NAME, userLanguagesMultiString, &langCount) || langCount == 0)
{
    swprintf_s(displayBuffer, SUFFICIENTLY_LARGE_ERROR_BUFFER,
               L"FAILURE: Unable to set the user defined languages, last error = %d.", GetLastError());
    MessageBoxW(NULL, displayBuffer, L"HelloMUI ERROR!", MB_OK | MB_ICONERROR);
    return 1; // Exit.
}
return 1;

Mengatur Preferensi Bahasa Aplikasi

MUI: Application-Specific Sampel Pengaturan (Windows Vista)

MUI: Sampel Pengaturan Application-Specific (Pre-Windows Vista)

 

 

  • Last updated on