支持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;
相关主题