Elements of the Skin Configuration File

The two elements in the config.xml file that define the Client’s skin configuration characteristics are the view and button elements. Button elements allow you to map keys to an area in the skin using a key value.

View Element

The view element contains attributes that determine the name and physical characteristics of the skin.The attributes for the view element include the following:

displayHeight

The height of the display screen, in pixels.

displayPosX

The horizontal position of the display screen, in pixels, with reference to the skin. Pixels are numbered from the left edge of the skin, starting with pixel 0.

displayPosY

The vertical position of the display screen, in pixels, with reference to the skin. Pixels are numbered from the top edge of the skin, starting with pixel 0.

displayWidth

The width of the display screen, in pixels.

mappingImage

The name of the color-coded mapping image (.bmp file) used to map keys that appear on the skin to specific functions or characters. The image file must be stored in the same directory as the config.xml file. Do not include the path in the filename.

skinImage

The name of the skin image (.bmp file). The image file must be stored in the same directory as the config.xml file. Do not include the path in the filename.

skinPosHeight

The height of the skin image bitmap, in pixels.

skinPosWidth

The width of the skin image bitmap, in pixels.

skinPosX

The initial horizontal position of the Studio Client, in pixels, with reference to the desktop display screen. Pixels are numbered from the left edge of the screen, starting with pixel 0.

skinPosY

The initial vertical position of the Studio Client, in pixels, with reference to the desktop display screen. Pixels are numbered from the top edge of the screen, starting with pixel 0.

status<XXX>

Not currently implemented.

TerminalID

The terminal identifier that matches the mobile device type. This identifier is defined by Wavelink.

titleBar

The name of the skin. When the Client is minimized, this name appears as the icon label in the taskbar.

Button Element

The button element in the config.xml file contains attributes that define the functionality of the mobile device keypad keys that appear on the skin. The attributes for the button element include the following:

mappingColor

Defines the color in the mapping image used to map a specific location in the mapping image to specific functions or characters. Valid values for this attribute include any valid RGB hex color. See Mapping Keys for a Skin for more information.

OnAlphaPressed

Defines the keypad command invoked for a specified key when the keypad is in Alpha mode. For a list of possible key values, see below.

For example: OnAlphaPressed="Key_K"

You can define a key to set Alpha mode by assigning it a value of Key_Alpha.

onClick

Defines the keypad command invoked for a specified key when the keyboard state is standard.

For example: onClick="Key_Apostrophe"

OnFuncPressed

Defines the keypad command invoked for a specified key when the keyboard state is in Function mode.

For example: OnFuncPressed="Key_Tab"

You can define a key to set Function mode by assigning it a value of Key_Func.

toolTip

The descriptive name for the button.

Key Values

This table contains a list of the key values you can use in the skin. Set key values for the following attributes:

onClick

OnFuncPressed

OnAlphaPressed

 

Key

Key

Key

"Key_Escape”

"Key_Y"

"Key_Slash"

"Key_F1"

"Key_U"

"Key_RightShift"

"Key_F2"

"Key_I"

"Key_Up"

"Key_F3"

"Key_O"

"KeyPad_1"

"Key_F4"

"Key_P"

"KeyPad_2"

"Key_F5"

"Key_LeftCurlyBracket"

"KeyPad_3"

"Key_F6"

"Key_RightCurlyBracket"

"KeyPad_Enter"

"Key_F7"

"Key_Backslash"

"Key_LeftCtrl"

"Key_F8"

"Key_Delete"

"Key_LeftWindows"

"Key_F9"

"Key_End"

"Key_LeftAlt"

"Key_F10"

"Key_PageDown"

"Key_Space"

"Key_F11"

"KeyPad_7"

"Key_RightAlt"

"Key_F12"

"KeyPad_8"

"Key_RightWindows"

"Key_LeftApostrophe"

"KeyPad_9"

"Key_Application"

"Key_1"

"KeyPad_Plus"

"Key_RightCtrl"

"Key_2"

"Key_A"

"Key_Left"

"Key_3"

"Key_S"

"Key_Down"

"Key_4"

"Key_D"

"Key_Right"

"Key_5"

"Key_F"

"KeyPad_0"

"Key_6"

"Key_G"

"KeyPad_DecimalPoint"

"Key_7"

"Key_H"

"Key_LeftSquareBracket"

"Key_8"

"Key_J"

"Key_RightSquareBracket"

"Key_9"

"Key_K"

"Key_DoubleQuote"

"Key_0"

"Key_L"

"Key_SingleLine"

"Key_Hyphen"

"Key_SemiColon"

"Key_Colon"

"Key_Equals"

"Key_SingleQuote"

"Key_Question"

"Key_Backspace"

"Key_Enter"

"Key_Tilda"

"Key_Insert"

"KeyPad_4"

"Key_CapsLock"

"Key_Home"

"KeyPad_5"

"Key_Prior"

"Key_PageUp"

"KeyPad_6"

"Key_Next"

"Key_NumLock"

"Key_LeftShift"

"Key_OnOff"

"KeyPad_Divide"

"Key_Z"

"Key_Func"

"KeyPad_Multiply"

"Key_X"

"Key_Underscore"

"KeyPad_Minus"

"Key_C"

"Key_PRTSCRN"

"Key_Tab"

"Key_V"

"Key_ScrollLock"

"Key_Q"

"Key_B"

"Key_NumLock"

"Key_W"

"Key_N"

"Key_Break"

"Key_E"

"Key_M"

"Key_Shift"

"Key_R"

"Key_Comma"

"Key_Ctrl"

"Key_T" (end)

"Key_Period" (end)

"Key_Alt"

 


Was this article useful?    

The topic was:

Inaccurate

Incomplete

Not what I expected

Other

Privacy and Legal