Understanding the Strings.xml file

The Strings.xml file is used to control what is printed on the device, including user interface labels, messages, logos, icons, and other graphics. This is the primary file used to customize the Unwired Accelerator .NET client. Resource names and values in the file equate to text or visual cues displayed on the screen.

Figure 1 shows several resource names and values, and the equivalent PDA screen representation.

Figure 1: Resource names and PDA screen equivalents

Following is a partial, sample Strings.xml file, with key resource names highlighted. See Table 3 for descriptions of these resource names.

<?xml version="1.0" encoding="utf-8" ?>
<root>
<Resource Name="TITLE_APPLICATION" Value="Unwired Accelerator" />
<Resource Name="FORMAT_DISPLAY_TEXT_RTL" Value="false" />
<Resource Name="FORMAT_FONT" Value="Arial" />
<Resource Name="FORMAT_LAST_DOWNLOAD_DATE_FORMAT" Value="yyyy-MM-dd hh:mm:ss" />
<Resource Name="FORMAT_LIST_VIEW_ROW_HEIGHT_FOR_DPI_96" Value="16" />
<Resource Name="FORMAT_LIST_VIEW_ROW_HEIGHT_FOR_DPI_192" Value="32" />
...
<Resource Name="MESSAGE_ASA_NOT_FOUND" Value="Adaptive Server Anywhere for Windows CE could not be found. This application will now exit." />
<Resource Name="MESSAGE_CAN_NOT_ACCESS_APPLICATION_DATA" Value="Unable to access Application data." />
<Resource Name="MESSAGE_CAN_NOT_CREATE_NEW_APPLICATION" Value="Can not create new Application." />
<Resource Name="MESSAGE_CAN_NOT_READ_PROFILE" Value="Can not read Profile." />
...
<Resource Name="STRING_ABORT" Value="Abort" />
<Resource Name="STRING_*ALL_COLUMNS*" Value="ALL COLUMNS" />
<Resource Name="STRING_APPLICATIONS" Value="Applications" />
...
<Resource Name="IMAGE_ADD_MOUSEUP_24" Value="add_white_24.bmp" />
<Resource Name="IMAGE_ADD_MOUSEDOWN_24" Value="add_black_24.bmp" />
<Resource Name="IMAGE_ADD_DISABLED_24" Value="add_disabled_24.bmp" />
...
</Root>

**Table 3: Resource names in Strings.xml**
Resource name	Description	Default value
`encoding`	Character encoding for Unicode. The default, UTF-8, is ideal for mobile device applications.	utf-8
`TITLE_APPLICATION`	The default application name for Unwired Accelerator that displays on the mobile device.	Unwired Accelerator
`FORMAT_DISPLAY_TEXT_RTL`	Indicates whether application text displays right to left on the mobile device. False indicates text displays left to right; true indicates text displays right to left.	false
`FORMAT_FONT`	The default application font used on the mobile device.	Arial
`FORMAT_LAST_DOWNLOAD_DATE_ FORMAT`	The date-time format used on the mobile device.	yyyy-MM-dd hh:mm:ss
`FORMAT_LIST_VIEW_ROW_HEIGHT_FOR_DPI_96`	The row height in pixels for 96 dots-per-inch (DPI).	16
`FORMAT_LIST_VIEW_ROW_HEIGHT_FOR_DPI_192`	The row height in pixels for 192 DPI.	32
`MESSAGE_message_text`	Message text, such as “Can not read Profile.” You can modify or localize each message.	See Table 4 for additional information about the messages.
`STRING_string_text`	Application labels, such as “Profile Name.” You can modify or localize each message. See Figure 1 for several string examples.	See Table 5 for additional information about the user interface strings.
`IMAGE_image_name`	Application images, such as buttons, graphics, and logos. Many images are provided in normal, selected, or unavailable style, and multiple sizes of images are available, depending on the mobile device window dimensions.	See Table 6 for additional information about images.

Messages in Strings.xml

Table 4 provides the message resources and their default values. You can change the default values, either by localizing the text or modifying it for your environment.

Some messages include variables, or placeholders, that are populated depending on the circumstances. For example, the message Delete {0}? includes one variable ( {0} ). During execution, the variable is replaced with another message or number, for example, the message might read Delete Stock?. Do not change the placeholder, just the text

**Table 4: Messages in Strings.xml**
Message resource	Default value
MESSAGE_ASA_NOT_FOUND	Adaptive Server Anywhere for Windows CE could not be found. This application will now exit.
MESSAGE_CAN_NOT_ACCESS_APPLICATION_DATA	Unable to access Application data.
MESSAGE_CAN_NOT_CREATE_NEW_ APPLICATION	Can not create new Application.
MESSAGE_CAN_NOT_READ_PROFILE	Can not read Profile.
MESSAGE_DELETE_ALL_APPLICATIONS?	Delete all Applications?
MESSAGE_DELETE_APPLICATION_X?	Delete {0}?
MESSAGE_DELETE_ALL_LOGS?	Delete all Logs?
MESSAGE_DELETE_LOG?	Delete the selected Log?
MESSAGE_DELETE_PROFILE_X?	Delete {0}? This will also delete all Applications related to this profile.
MESSAGE_ERROR_GETTING_SCREEN_ ORIENTATION_X	Error getting screen orientation: {0}
MESSAGE_ERROR_SETTING_SCREEN_ ORIENTATION_X	Error setting screen orientation: {0}
MESSAGE_HTTP_ERROR_X	HTTP Error: {0}
MESSAGE_INVALID_HTTP_RESPONSE	Invalid HTTP response.
MESSAGE_INVALID_LINKED_UA_ APPLICATION	The Unwired Accelerator linked application is invalid. Please notify your system administrator about this message and include the name of the application your are trying to synchronize.
MESSAGE_INVALID_PROFILE_KEY	Invalid Profile Key.
MESSAGE_INVALID_PROFILE_NAME	The profile name is empty.
MESSAGE_INVALID_PROFILE_PASSWORD	The profile password is empty.
MESSAGE_INVALID_PROFILE_PORT	The profile port number is invalid.
MESSAGE_INVALID_PROFILE_RID	The profile RID number is invalid.
MESSAGE_INVALID_PROFILE_SERVER	The profile server is empty.
MESSAGE_INVALID_PROFILE_USERNAME	The profile username is empty.
MESSAGE_INVALID_UA_VERSION_CANNOT_ SYNC_APP_X	The Unwired Accelerator server you are trying to synchronize with is not a version 7.0 server. The application {0} can not be synchronized.
MESSAGE_INVALID_VALUE_FOR_X	Invalid value for '{0}'.
MESSAGE_NETCF_1.0SP3_NOT_FOUND	This application requires that the .NET Compact Framework 1.0 Service Pack 3 be installed. This application will now exit.
MESSAGE_NO_RESX_STRING_FOR_X	No resource found for {0}.
MESSAGE_NO_APPLICATIONS_AVAILABLE	No Applications are available for download.
MESSAGE_PROFILE_NAME_NOT_UNIQUE	Another Profile already has this name. Please enter a unique name for this Profile.
MESSAGE_UA_AUTHENTICATION_FAILED	Unable to authenticate your username and password with the Unwired Accelerator server.
MESSAGE_UA_CONNECTION_FAILED	Unable to connect to the Unwired Accelerator server.
MESSAGE_UNABLE_TO_CONNECT_WITH_UA_SERVER	Unable to connect with the Unwired Accelerator server. Please check and verify your network access and coverage.
MESSAGE_UNABLE_TO_CREATE_LINKED_ APPLICATION	Unable to create the linked Application. Please notify your system administrator about this message and include the name of the application you are trying to synchronize.
MESSAGE_UNABLE_TO_FIND_TEMPLATE_X	Unable to find the template named: {0}
MESSAGE_UNKNOWN_UA_SERVER_ERROR	There was an unknown error on the Unwired Accelerator server. Please notify your system administrator.

Strings in Strings.xml

Table 5 provides the user interface string names found in Strings.xml. These are the labels, menu options, and so forth that appear on the application user interface. You can change the default values, either by localizing the text or modifying it for your environment.

Some messages include variables, or placeholders, that are populated depending on the circumstances. For example, the message Saving Record {0} of {1} includes two variables ( {0} and {1}). During execution, the variables are replaced with other messages, for example, the message might read Saving Record 20 of 25. Do not change the placeholder, just the text.

**Table 5: User interface string names in Strings.xml**
User interface string name	Default
STRING_ABORT	Abort
STRING_ALL_COLUMNS	ALL COLUMNS
STRING_APPLICATIONS	Applications
STRING_BACK	Back
STRING_BUILD_DATE:_X	Build Date: {0}
STRING_CANCEL	Cancel
STRING_CANCELLED	Cancelled
STRING_CONFIRM	Confirm
STRING_CURRENT_PROFILE	Current Profile
STRING_DELETE	Delete
STRING_DELETE_ALL	Delete All
STRING_DELETE_APPLICATION	Delete Application
STRING_DELETE_LOG	Delete Log
STRING_DELETE_PROFILE	Delete Profile
STRING_DELETING_LOGS	Deleting Logs
STRING_DESELECT_ALL	Deselect All
STRING_DETAIL	Detail
STRING_DETAIL_VIEW	Detail View
STRING_DOWNLOADING	Downloading
STRING_EDIT	Edit
STRING_EDIT_PROFILE	Edit Profile
STRING_EQUALS	Equals
STRING_ERROR	Error
STRING_EXIT	Exit
STRING_FAILED	Failed
STRING_IGNORE	Ignore
STRING_INSERT	Insert
STRING_INVERT_SELECTION	Invert Selection
STRING_LIKE	Like
STRING_LOG_DETAILS	Log Details
STRING_LOG	Log
STRING_LOGS	Logs
STRING_MENU	Menu
STRING_MESSAGE	Message
STRING_NEW	New
STRING_NEW_PROFILE	New Profile
STRING_NO	No
STRING_OK	OK
STRING_OPEN	Open
STRING_OVERALL_PROGRESS	Overall Progress
STRING_PASSWORD:	Password :
STRING_PORT:	Port :
STRING_PROFILE	Profile
STRING_PROFILE_NAME:	Profile Name :
STRING_PROFILES	Profiles
STRING_PROGRESS	Progress
STRING_REQUIREMENT_MISSING	Requirement Missing
STRING_RETRY	Retry
STRING_RID:	RID :
STRING_SAVE	Save
STRING_SAVED	Saved
STRING_SAVING	Saving
STRING_SAVING_RECORD_X_OF_Y	Saving Record {0} of {1}
STRING_SEARCH	Search
STRING_SEARCH_FOR:	Search For :
STRING_SEARCH_IN:	Search In :
STRING_SEARCH_TYPE:	Search Type :
STRING_SELECT_ALL	Select All
STRING_SENDING_UPDATES	Sending Updates
STRING_SERVER:	Server :
STRING_SHOW_ALL	Show All
STRING_SORT	Sort
STRING_STATUS	Status
STRING_STATUS:	Status:
STRING_SYNCHRONIZE_ALL	All
STRING_SYNCHRONIZE_SELECTED	Selected
STRING_SYNCHRONIZE	Synchronize
STRING_SYNCHRONIZE_UPDATES	Sync Updates
STRING_SYNCHRONIZATION_CANCELLED	Synchronization Cancelled
STRING_SYNCHRONIZING	Synchronizing
STRING_TIMESTAMP	Timestamp
STRING_TYPE	Type
STRING_USER_NAME:	User Name :
STRING_VALIDATION_FAILED	Validation Failed
STRING_VERSION:_X	Version: {0}
STRING_X/Y	{0}/{1}
STRING_YES	Yes

Images in Strings.xml

Table 6 provides image file names found in the Strings.xml file. You can change these images. To change an image, you actually need six images; for example:

Each button has three states (mouse up, mouse down, and disabled). The default buttons use a black background when selected, and a gray background when disabled, as a cue to the user.
Each button must be set to the proper size for both high (48x48 pixels) and low (24x24 pixels) resolution screens.

Files with the BMP extension work best.

**Table 6: Image file names in Strings.xml**
Image file name	Default
IMAGE_ADD_MOUSEUP_dpi_value	add_white_xx.bmp
IMAGE_ADD_MOUSEDOWN_dpi_value	add_black_xx.bmp
IMAGE_ADD_DISABLED_dpi_value	add_disabled_xx.bmp
IMAGE_BACK_MOUSEUP_dpi_value	back_white_xx.bmp
IMAGE_BACK_MOUSEDOWN_dpi_value	back_black_xx.bmp
IMAGE_BACK_DISABLED_dpi_value	back_disabled_xx.bmp
IMAGE_DELETE_MOUSEUP_dpi_value	delete_white_xx.bmp
IMAGE_DELETE_MOUSEDOWN_dpi_value	delete_black_xx.bmp
IMAGE_DELETE_DISABLED_dpi_value	delete_disabled_xx.bmp
IMAGE_EDIT_MOUSEUP_dpi_value	edit_white_xx.bmp
IMAGE_EDIT_MOUSEDOWN_dpi_value	edit_black_xx.bmp
IMAGE_EDIT_DISABLED_dpi_value	edit_disabled_xx.bmp
IMAGE_OPEN_MOUSEUP_dpi_value	folder_white_xx.bmp
IMAGE_OPEN_MOUSEDOWN_dpi_value	folder_black_xx.bmp
IMAGE_OPEN_DISABLED_dpi_value	folder_disabled_xx.bmp
IMAGE_SAVE_MOUSEUP_dpi_value	ave_white_xx.bmp
IMAGE_SAVE_MOUSEDOWN_dpi_value	save_black_xx.bmp
IMAGE_SAVE_DISABLED_dpi_value	save_disabled_xx.bmp
IMAGE_SYNC_MOUSEUP_dpi_value	sync_white_xx.bmp
IMAGE_SYNC_MOUSEDOWN_dpi_value	sync_black_xx.bmp
IMAGE_SYNC_DISABLED_dpi_value	sync_disabled_xx.bmp