com.softwareag.mobile.runtime.toolkit.resources

Class TKTextHandler

java.lang.Object

com.softwareag.mobile.runtime.media.TextHandler

com.softwareag.mobile.runtime.toolkit.resources.TKTextHandler

public class TKTextHandler
extends com.softwareag.mobile.runtime.media.TextHandler

This class extends TextHandler's functionality and adds some methods to manage languages.

TKTextHandler provides methods to load specific languages (loadLanguage(String) or loadLanguage(int)) and to get the system language (getSystemLanguage()), the default language (getDefaultLanguage()) or the current used language (getCurrentLanguage()).

The TKTextHandler is also responsible for setting the directionality (Left-to-Right or Right-to-Left) based on the language properties entered within the application model.

Version:

9.6.0.0000-0237

Field Summary

Fields

Modifier and Type	Field and Description
static TKTextHandler	instance
static java.lang.String	LOCALE_PROPERTY

Fields inherited from class com.softwareag.mobile.runtime.media.TextHandler

bitmap_font_image_ids, bitmap_font_info, enc_strings, languages, MD_TEXT_GUIDELINE_TYPE_MASK, set_font, system_font_colours, system_fonts, TEXTFLAG_CONTAINS_HYPHENATION_GUIDELINES

Constructor Summary

Constructors

Constructor and Description
TKTextHandler() Creates a new TKTextHandler and sets this instance as new TextHandler.instance.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	getCurrentLanguage() Returns language which is currently set.
java.lang.String	getDefaultLanguage() Returns default language.
int	getLanguageId(java.lang.String language) Checks if the given language exists in the system and returns its index.
java.lang.String	getSystemLanguage() Returns system language based on device locale.
java.lang.String	getTextResource(int parameter) Returns localized text resource or value from ContextKeyStore
void	initLanguage(int languageId, java.lang.String language, int directionality) Initializes language and its directionality.
void	loadLanguage(int languageId) Loads a single language and sets appropriated language directionality.
void	loadLanguage(java.lang.String language) Loads a single language.
void	setDefaultLanguage(java.lang.String languageName) Sets default language for the system.

Methods inherited from class com.softwareag.mobile.runtime.media.TextHandler

closestMatchDeviceLocaleLanguageID, closestMatchLocaleLanguageID, drawChars, drawCharsExtended, drawCharsOrString, drawSplitString, drawString, getBitmapFontCharacterIndex, getCharsWidth, getCharWidth, getENCString, getENCStringFromString, getFontHeight, getLanguageIDString, getMaxStringWidths, getString, getStringFromENCString, getStringWidth, insertENCStringIntoENCString, insertENCStringIntoString, insertStringIntoENCString, insertStringIntoString, loadBitmapFont, loadSystemFont, numLanguagesIncluded, replaceHardSpaces, setFont, splitENCString, splitString, unloadFont

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LOCALE_PROPERTY

public static final java.lang.String LOCALE_PROPERTY

See Also:

Constant Field Values

instance

public static TKTextHandler instance

Constructor Detail

TKTextHandler

public TKTextHandler()

Creates a new TKTextHandler and sets this instance as new TextHandler.instance.

Method Detail

getSystemLanguage

public java.lang.String getSystemLanguage()

Returns system language based on device locale.

getCurrentLanguage

public java.lang.String getCurrentLanguage()

Returns language which is currently set.

getLanguageId

public int getLanguageId(java.lang.String language)

Checks if the given language exists in the system and returns its index.

Parameters:

language - shortcut for language, e.g. "en"

Returns:

index which points to the appropriated language or -1 if no language was found.

loadLanguage

public void loadLanguage(java.lang.String language)

Loads a single language. If the specified language cannot be found, a default one will be loaded.

Parameters:

language - language to be loaded

loadLanguage

public void loadLanguage(int languageId)

Loads a single language and sets appropriated language directionality.

Overrides:

loadLanguage in class com.softwareag.mobile.runtime.media.TextHandler

initLanguage

public void initLanguage(int languageId,
                java.lang.String language,
                int directionality)

Initializes language and its directionality.

Parameters:

languageId - language index

language - language shortcut

directionality - language directionality

getDefaultLanguage

public java.lang.String getDefaultLanguage()

Returns default language. Initially it will be set based on the model

setDefaultLanguage

public void setDefaultLanguage(java.lang.String languageName)

Sets default language for the system.

Parameters:

languageName - language to be set as default

getTextResource

public java.lang.String getTextResource(int parameter)

Returns localized text resource or value from ContextKeyStore

Parameters:

parameter - text identifier to be loaded or key for ContextKeyStore