支援語言設定Application-Specific
您的應用程式可以從目標作業系統所支援的語言支援一組不同的使用者介面語言。 本主題討論這種類型的支援，使用來自完整範例的程式碼片段。
解譯使用者的語言喜好設定
您的應用程式必須先根據使用者喜好設定來判斷要顯示的使用者介面語言。 程式碼可以從組態檔或登錄設定讀取設定。
下列範例定義用來解譯使用者語言喜好設定的兩個函式。 第一個函式說明從檔案讀取分隔的語言清單，並以 「langs.txt」 表示的程式碼。 範例中支援的分隔符號為 「，」，「;」;「.」 和 「 」 。 第二個函式會將從檔案讀取的字串轉換為多字串值。 這項作業是必要的，因為用來設定語言的 MUI 函式只接受多字串值。
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;
}
設定應用程式語言
讀取語言喜好設定資訊之後，應用程式程式碼必須使用擷取的設定來設定應用程式語言。 在 Windows 7 和更新版本上，應用程式可以藉由呼叫 SetProcessPreferredUILanguages 函式，在進程層級設定語言。
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.
}
在 Windows Vista 和更新版本上，應用程式語言是藉由呼叫 SetThreadPreferredUILanguages 函式，線上程層級設定。
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;
相關主題