UF_TEXT_init_native_lang_support (view source)
Defined in: uf_text.h
Overview
Initializes the system for native language support.
Environment
Internal and External
History
Originally released in NX 602
Required License(s)
gateway
int UF_TEXT_init_native_lang_support
(
void
)
UF_TEXT_load_translation_file (view source)
Defined in: uf_text.h
Overview
This routine allows the programmer to load a translation file that will be
used to translate strings from English into the users native language. This
file will be used in addition to the standard ugii.lng that contains the
translations for NX messages and dialogs.
The Open API programmer is responsible for creating this file using the
NLDMGR tool as described in the NX Internationalization and
Localization online help.
Environment
Internal and External
History
Originally released in V18.0
Required License(s)
gateway
int UF_TEXT_load_translation_file
(
const char * file
)
| const char * | file | Input | This is the complete path to the file to be loaded. When
NX displays the user interface, it will use the
contents of this file to try and translate strings into
the users language.
Translation strings that exist in the NX language
file found in $UGII_LANGUAGE/ugii.lng will always be used
first. If a translation is not found in that file, then
this file will be searched. |
UF_TEXT_set_text_mode (view source)
Defined in: uf_text.h
Overview
This routine sets the text mode for a user function program. UF_initialize
defaults the text mode to UF_TEXT_LOCALE. This routine is provided to let the
user function programmer change the default behavior. When text strings are
returned in the locale, International characters may be lost, if they exist in
the part.
Environment
Internal and External
Required License(s)
gateway
int UF_TEXT_set_text_mode
(
UF_TEXT_mode_t mode
)
| UF_TEXT_mode_t | mode | Input | One of the following enumerated text mode constants:
UF_TEXT_LOCALE
UF_TEXT_UTF8 |
UF_TEXT_translate_string (view source)
Defined in: uf_text.h
Overview
This routine allows the programmer to translate a C string
from English into the users native language. The strings to translate
should be contained in the file loaded using UF_TEXT_load_translation_file.
If no translation is found the original string is used.
Environment
Internal and External
History
Originally released in NX 2
Required License(s)
gateway
int UF_TEXT_translate_string
(
const char* source,
int size,
char* const xstring
)
| const char* | source | Input | This is the English source string to be translated. |
| int | size | Input | size in bytes of the xstring buffer |
| char* const | xstring | Output | This is the buffer to return the string
translated into the users native language.
If the source string is not translated
xstring receives the source string unchanged.
This buffer must be allocated by the caller of
UF_TEXT_translate_string. |
UF_TEXT_translate_string_2 (view source)
Defined in: uf_text.h
Overview
This routine allows the programmer to translate a C string
from English into the users native language. The strings to translate
should be contained in the file loaded using UF_TEXT_load_translation_file.
If no translation is found the original string is used. You must use UF_free
to deallocate space used by xstring.
Environment
Internal and External
History
Originally released in NX 602
Required License(s)
gateway
int UF_TEXT_translate_string_2
(
const char* source,
char* * xstring
)
| const char* | source | Input | This is the English source string to be translated. |
| char* * | xstring | Output to be freed | This returns the string translated into the users
native language. If the source string is not translated
xstring receives the source string unchanged.
Use UF_free to deallocate memory when done. |