Sets the locale for the annotation library.
#include "l_bitmap.h"
L_LTANN_API L_TCHAR * L_AnnSetlocale(nCategory, lpszLocale)
Category affected by locale.
Locale name. Pass NULL to return the current locale.
Value | Meaning |
---|---|
!NULL | A pointer to the string representing the specified locale and category |
NULL | Indicates that the category or locale parameter value was invalid |
This function is used under rare circumstances. It is necessary only when running non-unicode applications that must display text that is not part of the ASCII character set (for example, Japanese characters). Non-ASCII text (i.e. a Japanese or Arabic character) can be stored non-ambiguously in unicode. However, for non-unicode applications, the multi-byte representation of such characters depends on the code page. In this case, you must set the code page appropriately. For example, a non-unicode annotation application can display Japanese characters only if the code page is set to a Japanese code page (like Japanese_Japan.932).
Pass NULL for the parameter pszLocale to get the current locale, leaving the current locale unchanged.
Note that in the MAIN C API annotation demo, you can change the locale using L_AnnSetlocale. Internally, this function calls Microsoft C API setlocale. For details, see the MSDN documentation.
Win32, x64.
This example shows how to set the locale of the annotation library.
#include <locale.h>
L_TCHAR* DisplayCurrentLocale()
{
L_TCHAR szMsg[200];
// Display the current locale
L_TCHAR* pszMsg = L_AnnSetlocale(LC_ALL, NULL);
if (pszMsg != NULL)
{
wsprintf(szMsg, _T("Current Locale: %s"), pszMsg);
_tprintf(_T("%s"), szMsg);
}
return pszMsg;
}
L_INT AnnSetlocaleExample()
{
L_TCHAR* pszOriginalLocale = DisplayCurrentLocale();
// Set the locale for English/United states
L_AnnSetlocale(LC_ALL, TEXT("English"));
DisplayCurrentLocale();
// Set the locale for Japanese
L_AnnSetlocale(LC_ALL, TEXT("Japanese"));
DisplayCurrentLocale();
// Set the locale for Arabic
L_AnnSetlocale(LC_ALL, TEXT("Arabic"));
DisplayCurrentLocale();
// Set to the original locale
L_AnnSetlocale(LC_ALL, pszOriginalLocale);
DisplayCurrentLocale();
return SUCCESS;
}
Help Collections
Raster .NET | C API | C++ Class Library | HTML5 JavaScript
Document .NET | C API | C++ Class Library | HTML5 JavaScript
Medical .NET | C API | C++ Class Library | HTML5 JavaScript
Medical Web Viewer .NET
Multimedia
Direct Show .NET | C API | Filters
Media Foundation .NET | C API | Transforms
Supported Platforms
.NET, Java, Android, and iOS/macOS Assemblies
Imaging, Medical, and Document
C API/C++ Class Libraries
Imaging, Medical, and Document
HTML5 JavaScript Libraries
Imaging, Medical, and Document
Your email has been sent to support! Someone should be in touch! If your matter is urgent please come back into chat.
Chat Hours:
Monday - Friday, 8:30am to 6pm ET
Thank you for your feedback!
Please fill out the form again to start a new chat.
All agents are currently offline.
Chat Hours:
Monday - Friday
8:30AM - 6PM EST
To contact us please fill out this form and we will contact you via email.