| Skin Author's Guide to Adaptive User Interface Technology
|
   
|
Referencing the skin_constants.xml File
|
The skin_constants.xml file is a reference file provided by the Java Wireless Client Adaptive User Interface Technology. It is not meant to be altered or amended. Its purpose is to provide a complete list of property settings, with explanations, for each of the seventeen graphic components provided by the AUIT.
These graphic components include the following items:
The remainder of this chapter is composed of tables listing the property settings of the graphic components defined in the skin_constants.xml file, as well as explanations for each property setting.
The skin_constants.xml file does not assign values to the properties listed in the the following tables. Values are assigned to these properties in the skin.xml file. For an understanding of the relationship between these two XML files, see Chapter 2.
|
Note - Although the adaptive user interface property definitions and the values assigned to those property definitions are separated into two files, skin_constants.xml and skin.xml, the property explanations and the values assigned to them in the default skin are listed together in the tables in this chapter. This is for your ease of use.
|
Table Format Used in This Chapter
All tables shown in this chapter contain the following four columns:
- Property (Key) - Lists the name of the property defined in the skin_contants.xml file. This property is also assigned to the Key field in the skin.xml file.
- Type - Lists the property type defined in the skin.xml file. For example, the type could be font, image, composite image, integer, integer sequence, or string.
- Value - Lists the value assigned to the property in the skin.xml file. This is the value used by the default skin.
|
Note - To customize the default skin for your own unique look and feel, you must reassign the values of each adaptive user interface property in the skin.xml file that you wish to modify or change. The skin_constants.xml file is for reference only. Do not change it.
|
- Description - Gives a partial description of the property and its purpose in the adaptive user interface. For a complete description of the property, see the skin_constants.xml file, found in the following directory location:
InstallDir/src/configuration/configuration_xml/share/chameleon
System Components
When developing a skin that uses adaptive user interface software, you must begin by customizing the system components. This section describes the property settings used to skin the following adaptive user interface software system components:
Screen Properties
The AUIT skin element that should be customized first is the screen and its properties. These include items such as the standard display background, foreground colors, and fonts. TABLE 4-1 lists all the property settings for the screen component defined in the skin_constants.xml file and the values assigned to them in the skin.xml file.
TABLE 4-1 Screen Property Settings
|
Property (Key)
|
Type
|
Value
|
Description
|
|
SCREEN_TEXT_ORIENT
|
integer
|
Graphics.RIGHT
|
The orientation of text. A value of Graphics.RIGHT indicates text that reads from left to right.
|
|
SCREEN_PAD_FORM_ITEMS
|
integer
|
4
|
The amount of padding (in pixels) between items in a form.
|
|
SCREEN_PAD_LABEL_VERT
|
integer
|
2
|
The amount of padding (in pixels) around the top and bottom of a label.
|
|
SCREEN_PAD_LABEL_HORIZ
|
integer
|
3
|
The amount of padding (in pixels) around the left and right of a label.
|
|
SCREEN_COLOR_BG
|
integer
|
0xFFFFFF
|
The background color for a screen.
|
|
SCREEN_COLOR_HS_BG
|
integer
|
0xFFFFFF
|
The background color for the home screen. The home screen is the primary screen to which a user returns as the starting and ending point of activities in an interface.
|
|
SCREEN_COLOR_FG
|
integer
|
0x000000
|
The foreground color for a screen.
|
|
SCREEN_COLOR_BG_HL
|
integer
|
0xFFCC33
|
The background highlight color for highlighted elements.
|
|
SCREEN_COLOR_FG_HL
|
integer
|
0x000000
|
The foreground highlight color for highlighted elements.
|
|
SCREEN_COLOR_BORDER
|
integer
|
0x000000
|
The color to use for a border around a custom item.
|
|
SCREEN_COLOR_BORDER_HL
|
integer
|
0xFFCC33
|
The color to use for a border around a custom item which is currently highlighted.
|
|
SCREEN_COLOR_TRAVERSE_IND
|
integer
|
0xFFCC33
|
The color with which to draw a traversal indicator for elements which must do so (such as custom items).
|
|
SCREEN_BORDER_STYLE
|
integer
|
Graphics.SOLID
|
The style of border for those visual elements which draw a border. Graphics.SOLID indicates a solid border.
|
|
SCREEN_FONT_LABEL
|
font
|
FontResources.PROP_P_M
|
The font to use when rendering Item labels in a Form.
|
|
SCREEN_FONT_INPUT_TEXT
|
font
|
FontResources.PROP_P_M
|
The font to use as the predefined Font.INPUT_TEXT font.
|
|
SCREEN_FONT_STATIC_TEXT
|
font
|
FontResources.PROP_P_M
|
The font to use as the predefined Font.STATIC_TEXT font.
|
|
SCREEN_IMAGE_WASH
|
image
|
screen.image_wash
(ROMized)
|
The image to use as a tile to paint a "wash" over the rest of the screen contents.
|
|
SCREEN_IMAGE_BG
|
image
|
screen.image_bg
(not ROMized)
|
The image to use as a tile for the typical screen background.
|
|
SCREEN_IMAGE_BG_W_TITLE
|
composite
image
|
screen.image_bg_w._title
(not ROMized)
|
The nine-piece image background to use for the typical screen background with a title.
|
|
SCREEN_IMAGE_BG_WO_TITLE
|
composite
image
|
screen.image_bg_wo_title
(not ROMized)
|
The nine-piece image background to use for the typical screen background without a title.
|
|
SCREEN_IMAGE_HS_BG_TILE
|
image
|
screen.image_hs_bg_tile
|
The image to use as a tile for the home screen background.
|
|
SCREEN_IMAGE_HS_BG_W_TITLE
|
composite
image
|
screen.image_hs_bg_w_title
(not ROMized)
|
The nine-piece image background to use for the home screen background with a title.
|
|
SCREEN_IMAGE_HS_BG_WO_TITLE
|
composite
image
|
screen.image.hs_bg_wo_title
(not ROMized)
|
The nine-piece image background to use for the home screen background without a title
|
Title Bar Properties
Skinning a title bar for use with adaptive user interface software requires you to reassign values to the properties listed in TABLE 4-2. This table contains the Title Bar property settings defined in the skin_constants.xml file and the values assigned to those properties in the skin.xml file.
TABLE 4-2 Title Bar Property Settings
|
Property (Key)
|
Type
|
Value
|
Description
|
|
TITLE_HEIGHT
|
integer
|
20
|
The overall height of the title component
|
|
TITLE_MARGIN
|
integer
|
5
|
The margin (in pixels) to leave on either side of the layer when rendering its text
|
|
TITLE_TEXT_ALIGN_X
|
integer
|
Graphics.LEFT
|
The horizontal alignment of the text
|
|
TITLE_TEXT_SHD_ALIGN
|
integer
|
Graphics.BOTTOM | Graphics.RIGHT
|
The alignment property of the drop shadow on the title text
|
|
TITLE_COLOR_FG
|
integer
|
0xFFFFFF
|
The foreground color to use when rendering the title text
|
|
TITLE_COLOR_FG_SHD
|
integer
|
0x000000
|
The shadow color to use when rendering the title text
|
|
TITLE_COLOR_BG
|
integer
|
0x1F3FB1
|
The background fill color to use if no background image
|
|
TITLE_FONT
|
font
|
FontResources.SYS_B_M
|
The font to use when rendering the title text
|
|
TITLE_IMAGE_BG
|
composite
image
|
title.image_bg
|
The three-piece background image to use in the title bar
|
Scroll Bar Properties
Skinning a scroll bar for use with adaptive user interface software requires you to reassign values to the properties listed in TABLE 4-3. This table contains the Scroll Bar property settings defined in the skin_constants.xml file and the values assigned to those properties in the skin.xml file.
TABLE 4-3 Scroll Bar Property Settings
|
Property (Key)
|
Type
|
Value
|
Description
|
|
SCROLL_MODE
|
integer
|
0
|
The mode of the scroll indicator. The choices are bar mode or arrow mode
|
|
SCROLL_WIDTH
|
integer
|
9
|
The width of the scroll indicator
|
|
SCROLL_COLOR_BG
|
integer
|
0x000000
|
The background fill color for the scroll indicator in bar mode
|
|
SCROLL_COLOR_FG
|
integer
|
0xFFFFFF
|
The foreground fill color for the scroll indicator in bar mode
|
|
SCROLL_IMAGE_BG
|
composite
image
|
scroll.image_bg
(not ROMized)
|
A three-piece background image used to render the background of the scroll indicator in bar mode
|
|
SCROLL_IMAGE_FG
|
composite
image
|
scroll.image_fg
(not ROMized)
|
A three-piece foreground image to use to render the "thumb" of the scroll indicator in bar mode
|
|
SCROLL_IMAGE_UP
|
image
|
scroll.image_up
(ROMized)
|
The up arrow for a scroll indicator in arrow mode
|
|
SCROLL_IMAGE_DN
|
image
|
scroll.image_dn
(ROMized)
|
The down arrow for a scroll indicator in arrow mode
|
|
SCROLL_COLOR_AU_BG
|
integer
|
0x000000
|
The background fill color for the scroll indicator in bar mode when used as an Alert
|
|
SCROLL_COLOR_AU_FG
|
integer
|
0xFFFFFF
|
The foreground fill color for the scroll indicator in bar mode when used as an Alert
|
|
SCROLL_IMAGE_AU_BG
|
composite
image
|
scroll.image_au_bg
(not ROMized)
|
A three-piece background image to use to render the background of the scroll indicator in bar mode when used as an Alert
|
|
SCROLL_IMAGE_AU_FG
|
composite
image
|
scroll.image_au_fg
(not ROMized)
|
A three-piece background image to use to render the "thumb" of the scroll indicator in bar mode when used as an Alert
|
|
SCROLL_IMAGE_AU_UP
|
image
|
scroll.image_au_up
(ROMized)
|
The up arrow for a scroll indicator in arrow mode for an Alert
|
|
SCROLL_IMAGE_AU_DN
|
image
|
scroll.image_au_dn
(ROMized)
|
The down arrow for a scroll indicator in arrow mode for an Alert
|
Soft Button Bar Properties
Skinning a soft button bar for use with adaptive user interface software requires you to reassign values to the properties listed in TABLE 4-4. This table contains the SoftButton Bar property settings defined in the skin_constants.xml file and the values assigned to those properties in the skin.xml file.
TABLE 4-4 Soft Button Bar Property Settings
|
Property (Key)
|
Type
|
Value
|
Description
|
|
SOFTBTN_HEIGHT
|
integer
|
18
|
The overall height of the soft button bar
|
|
SOFTBTN_NUM_BUTTONS
|
integer
|
2
|
The number of soft buttons to represent on the soft button bar
|
|
SOFTBTN_BUTTON_SHD_ALIGN
|
integer
|
Graphics.BOTTOM |
Graphics.RIGHT
|
The alignment property of the drop shadow on the button text
|
|
SOFTBTN_COLOR_FG
|
integer
|
0xFFFFFF
|
The text foreground color for buttons
|
|
SOFTBTN_COLOR_FG_SHD
|
integer
|
0x000000
|
The text drop shadow color for buttons
|
|
SOFTBTN_COLOR_BG
|
integer
|
0x264DB6
|
The solid fill color for the button bar
|
|
SOFTBTN_COLOR_MU_FG
|
integer
|
0xFFFFFF
|
The text foreground color for buttons on the button bar when the system menu is displayed
|
|
SOFTBTN_COLOR_MU_FG_SHD
|
integer
|
0x000000
|
The text drop shadow color for buttons on the button bar when the system menu is displayed
|
|
SOFTBTN_COLOR_MU_BG
|
integer
|
0xFF9933
|
The solid fill color for the button bar when the system menu is displayed
|
|
SOFTBTN_COLOR_AU_FG
|
integer
|
0xFFFFFF
|
The text foreground color for buttons on the button bar when a system alert is displayed
|
|
SOFTBTN_COLOR_AU_FG_SHD
|
integer
|
0x000000
|
The text drop shadow color for the button bar when a system alert is displayed
|
|
SOFTBTN_COLOR_AU_BG
|
integer
|
0xF06409
|
The solid fill color for the button bar when a system alert is displayed
|
|
SOFTBTN_FONT
|
font
|
FontResources.SYS_B_M
|
The font to use to render the soft button text
|
|
SOFTBTN_TEXT_MENUCMD
|
string
|
Menu
|
The softbutton label to use to represent that pressing the soft button brings up the system menu
|
|
SOFTBTN_TEXT_BACKCMD
|
string
|
Back
|
The soft button label to use for the command that closes the system menu once it is opened
|
|
SOFTBTN_IMAGE_BG
|
composite
image
|
softbtn.image_bg
(ROMized)
|
The three-piece background image of the button bar
|
|
SOFTBTN_IMAGE_MU_BG
|
composite
image
|
softbtn.image_mu_bg
(ROMized)
|
The three-piece background image for the button bar when the system menu is displayed
|
|
SOFTBTN_IMAGE_AU_BG
|
composite
image
|
softbtn.image_au_bg
(ROMized)
|
The three-piece background image for the button bar when a system alert is displayed
|
|
SOFTBTN_BUTTON_ALIGN_X
|
integer
|
Graphics.LEFT, Graphics.RIGHT
|
The alignment property of a button around its anchor point
|
|
SOFTBTN_BUTTON_MAX_WIDTH
|
integer
sequence
|
85, 85
|
The maximum width (in pixels) to allow for a button
|
|
SOFTBTN_BUTTON_ANCHOR_X
|
integer
sequence
|
5, -5
|
The x-coordinate for the anchor point of a button
|
|
SOFTBTN_BUTTON_ANCHOR_Y
|
integer
sequence
|
0, 0
|
The y-coordinate for the anchor point of a button
|
Ticker Properties
Skinning a ticker for use with adaptive user interface software requires you to reassign values to the properties listed in TABLE 4-5. This table contains the Ticker property settings defined in the skin_constants.xml file and the values assigned to those properties in the skin.xml file.
TABLE 4-5 Ticker Property Settings
|
Property (Key)
|
Type
|
Value
|
Description
|
|
TICKER_HEIGHT
|
integer
|
17
|
The overall height of the ticker (in pixels)
|
|
TICKER_ALIGN
|
integer
|
Graphics.BOTTOM
|
The vertical alignment of the ticker
|
|
TICKER_DIRECTION
|
integer
|
Graphics.LEFT
|
The direction of motion of the text in the ticker
|
|
TICKER_RATE
|
integer
|
250
|
The amount of time (in milliseconds) between subsequent ticker text updates
|
|
TICKER_SPEED
|
integer
|
5
|
The rate of movement per cycle for the ticker text (in pixels)
|
|
TICKER_TEXT_ANCHOR_Y
|
integer
|
1
|
The y-coordinate of the anchor point for the ticker text
|
|
TICKER_TEXT_SHD_ALIGN
|
integer
|
Graphics.BOTTOM |
Graphics.RIGHT
|
The alignment directive for the drop shadow of the ticker text
|
|
TICKER_COLOR_BG
|
integer
|
0x96DBDB
|
The background fill color for the ticker, if its background image isn't specified or can't be loaded
|
|
TICKER_COLOR_FG
|
integer
|
0x000000
|
The foreground color for rendering the text of this ticker
|
|
TICKER_COLOR_FG_SHD
|
integer
|
0xCCCCFF
|
The drop shadow color of the text of the ticker
|
|
TICKER_FONT
|
font
|
FontResources.SYS_B_S
|
The font to render the text of this ticker
|
|
TICKER_IMAGE_BG
|
composite
image
|
ticker.image_bg
(ROMized)
|
The three-piece background image to be used for the ticker
|
|
TICKER_IMAGE_AU_BG
|
composite
image
|
ticker.image_au_bg
(not ROMized)
|
The three-piece background image to be used for this ticker when a system alert is visible
|
System Menu Properties
Skinning a system menu for use with adaptive user interface software requires you to reassign values to the properties listed in TABLE 4-6. This table contains the system menu property settings defined in the skin_constants.xml file and the values assigned to those properties in the skin.xml file.
TABLE 4-6 System Menu Property Settings
|
Property (Key)
|
Type
|
Value
|
Description
|
|
MENU_WIDTH
|
integer
|
144
|
The maximum overall width of the system menu component
|
|
MENU_HEIGHT
|
integer
|
159
|
The maximum overall height of the system menu component
|
|
MENU_ALIGN_X
|
integer
|
Graphics.RIGHT
|
The alignment property of the system menu on the x-axis
|
|
MENU_ALIGN_Y
|
integer
|
Graphics.BOTTOM
|
The alignment property of the system menu on the y-axis
|
|
MENU_TITLE_X
|
integer
|
80
|
The x-coordinate for the anchor point of the system menu title
|
|
MENU_TITLE_Y
|
integer
|
2
|
The y-coordinate for the anchor point of the system menu title
|
|
MENU_TITLE_MAXWIDTH
|
integer
|
100
|
The maximum width allowed for the system menu title
|
|
MENU_TITLE_ALIGN
|
integer
|
Graphics.HCENTER
|
The horizontal alignment property of the system menu around its anchor point
|
|
MENU_MAX_ITEMS
|
integer
|
9
|
The maximum number of items the system menu can display at once
|
|
MENU_ITEM_HEIGHT
|
integer
|
15
|
The height (in pixels) of each option in the system menu
|
|
MENU_ITEM_TOPOFFSET
|
integer
|
21
|
The offset (in pixels) from the top of the menu to the origin of the y-value of the first menu item
|
|
MENU_ITEM_INDEX_ANCHOR_X
|
integer
|
8
|
The x-coordinate of the starting location for the index of each menu item
|
|
MENU_ITEM_ANCHOR_X
|
integer
|
18
|
The x-coordinate of the starting location for the string value or each menu item
|
|
MENU_COLOR_BG
|
integer
|
0xFFEAA1
|
The background fill-color to use in lieu of using a background image
|
|
MUNU_COLOR_BG_SEL
|
integer
|
0xFFCC33
|
The background fill color to use for the currently highlighted menu item in lieu of using a background image
|
|
MENU_COLOR_TITLE
|
integer
|
0x000000
|
The foreground color to use to render the system menu title if one if used
|
|
MENU_COLOR_INDEX
|
integer
|
0x000000
|
The non-selected foreground color to use to render the index of each item on the menu
|
|
MENU_COLOR_INDEX_SEL
|
integer
|
0x000000
|
The foreground color to use to render the index of the selected item on the menu
|
|
MENU_C0LOR_iTEM
|
integer
|
0x000000
|
The non-selected foreground color to use to render items on the menu
|
|
MENU_COLOR_ITEM_SEL
|
integer
|
0x000000
|
The foreground color to use to render the selected item on the menu
|
|
MENU_TEXT_TITLE
|
string
|
Menu
|
The actual title of the system menu
|
|
MENU_FONT_TITLE
|
font
|
FontResources.SYS_B_S
|
The font to use to render the system menu title
|
|
MENU_FONT_ITEM
|
font
|
FontResources.SYS_P_M
|
The font to use to render all non-selected items and their indexes on the menu
|
|
MENU_FONT_ITEM_SEL
|
font
|
FontResources.SYS_B_M
|
The font to use to render the currently selected item and its index on the menu
|
|
MENU_IMAGE_BG
|
composite
image
|
menu.image_bg
(not ROMized)
|
The nine-piece background image to be used for the system menu
|
|
MENU_IMAGE_ITEM_SEL_BG
|
composite
image
|
menu.image_item_sel_bg
(not ROMized)
|
The three-piece background image for a selected menu item
|
|
MENU_IMAGE_SUBMENU
|
image
|
menu.image_submenu
(not ROMized)
|
The image displayed to indicate a submenu when a menu item is not currently selected
|
|
MENU_IMAGE_SUBMENU_HL
|
image
|
menu.image_submenu_hl
(not ROMized)
|
The image displayed to indicate a submenu when a menu item is currently selected
|
System Alert Properties
Skinning a system alert for use with adaptive user interface software requires you to reassign values to the properties listed in TABLE 4-7. This table contains the system alert property settings defined in the skin_constants.xml file and the values assigned to those properties in the skin.xml file.
TABLE 4-7 System Alert Property Settings
|
Property (Key)
|
Type
|
Value
|
Description
|
|
ALERT_WIDTH
|
integer
|
1
|
The overall width of an Alert
|
|
ALERT_HEIGHT
|
integer
|
125
|
The height for an Alert
|
|
ALERT_ALIGN_X
|
integer
|
Graphics.HCENTER
|
The horizontal alignment of an Alert on the screen
|
|
ALERT_ALIGN_Y
|
integer
|
Graphics.BOTTOM
|
The vertical alignment of an Alert on the screen
|
|
ALERT_MARGIN_H
|
integer
|
5
|
The width (in pixels) for the horizontal margins of an Alert
|
|
ALERT_MARGIN_V
|
integer
|
0
|
The height (in pixels) for the vertical margins of an Alert
|
|
ALERT_TITLE_ALIGN
|
integer
|
Graphics.LEFT
|
The alignment directive for the title in the title bar
|
|
ALERT_TITLE_HEIGHT
|
integer
|
32
|
The overall height of the title bar in an Alert
|
|
ALERT_TITLE_MARGIN
|
integer
|
5
|
The width of the margin (in pixels) on either side of the title in an Alert
|
|
ALERT_TEXT_TITLE_INFO
|
string
|
Information
|
The default title for an info type Alert
|
|
ALERT_TEXT_TITLE_WARN
|
string
|
Warning
|
The default title for a warning type Alert
|
|
ALERT_TEXT_TITLE_ERRR
|
string
|
Error
|
The default title for an error type Alert
|
|
ALERT_TEXT_TITLE_ALRM
|
string
|
Alarm
|
The default title for an alarm type Alert
|
|
ALERT_TEXT_TITLE_CNFM
|
string
|
Confirm
|
The default title for a confirm type Alert
|
|
ALERT_PAD_HORIZ
|
integer
|
0
|
The amount of padding (in pixels) between some elements on a row (such as the icon and the title)
|
|
ALERT_PAD_VERT
|
integer
|
3
|
The amount of padding (in pixels) between two rows of elements
|
|
ALERT_SCROLL_AMOUNT
|
integer
|
15
|
The amount of pixels to scroll the contents of the Alert at one time
|
|
ALERT_TIMEOUT
|
integer
|
2000
|
The time out (in milliseconds) for an Alert
|
|
ALERT_COLOR_BG
|
integer
|
0xFFCC33
|
The background fill color to be used for Alerts when the background image cannot be loaded or does not exist
|
|
ALERT_COLOR_TITLE
|
integer
|
0x000000
|
The foreground color for the Alert's title text
|
|
ALERT_COLOR_FG
|
integer
|
0x000000
|
The foreground color for the Alert's contents
|
|
ALERT_FONT_TITLE
|
font
|
FontResources.PROP_B_S
|
The font to use to render the Alert's title text
|
|
ALERT_FONT_TEXT
|
font
|
FontResources.PROP_P_M
|
The font to use to render the Alert's contents
|
|
ALERT_IMAGE_BG
|
composite
image
|
alert.image_bg
(not ROMized)
|
The nine-piece background to use for the Alert
|
|
ALERT_IMAGE_ICON_INFO
|
image
|
alert.image_icon_info
(not ROMized)
|
The icon for an information type Alert
|
|
ALERT_IMAGE_ICON_WARN
|
image
|
alert.image_icon_warn
(not ROMized)
|
The icon for a warning type Alert
|
|
ALERT_IMAGE-ICON_ERRR
|
image
|
alert.image_icon_errr
(not ROMized)
|
The icon for an error type Alert
|
|
ALERT_IMAGE_ICON_ALRM
|
image
|
alert.image_icon_alrm
(not ROMized)
|
The icon for an alarm type Alert
|
|
ALERT_IMAGE_ICON_CNFM
|
image
|
alert.image_icon_cnfm
(not ROMized)
|
The icon for a confirmation type Alert
|
System Widgets
Once you finish customizing the adaptive user interface system components, then customize the system widgets. This section describes the property settings used to skin the adaptive user interface software system widgets in the following sections:
Busy Cursor Properties
Skinning a busy cursor for use with adaptive user interface software requires you to reassign values to the properties listed in TABLE 4-8. This table contains the busy cursor property settings defined in the skin_constants.xml file and the values assigned to those properties in the skin.xml file.
TABLE 4-8 Busy Cursor Property Settings
|
Property (Key)
|
Type
|
Value
|
Description
|
|
BUSYCRSR_WIDTH
|
integer
|
40
|
The width of the busy cursor
|
|
BUSYCRSR_HEIGHT
|
integer
|
40
|
The height of the busy cursor
|
|
BUSYCRSR_NUM_FRAMES
|
integer
|
17
|
The number of frames that contribute to the animation of the busy cursor
|
|
BUSYCRSR_FRAME_X
|
integer
|
0
|
The x-coordinate of the animation region of the busy cursor
|
|
BUSRYCRSR_FRAME_Y
|
integer
|
0
|
The y-coordinate of the animation region of the busy cursor
|
|
BUSYCRSR_FRAME_SEQU
|
integer
sequence
|
1,2,3,4,5,6,7,8,9,10,11,12,13,12,11,10,9,8,7,6,5,4,3,2
|
The sequence in which the frames are animated
|
|
BUSRYCRSR_IMAGE_BG
|
image
|
busycrsr.image_bg
(not ROMized)
|
The image to be used for the background of the busy cursor
|
|
BUSYCRSR_IMAGE_FRAME
|
composite
image
|
busycrsr.image_frame
(not ROMized)
|
All the images that contribute to the animation of the busy cursor. This equals the number of images defined in BUSYCRSR_NUM_FRAMES.
|
Choice Group Properties
Skinning a choice group for use with adaptive user interface software requires you to reassign values to the properties listed in TABLE 4-9. This table contains the choice group property settings defined in the skin_constants.xml file and the values assigned to those properties in the skin.xml file.
TABLE 4-9 Choice Group Property Settings
|
Property (Key)
|
Type
|
Value
|
Description
|
|
CHOICE_WIDTH_IMAGE
|
integer
|
16
|
The maximum width for an application-supplied image for a choice element
|
|
CHOICE_HEIGHT_IMAGE
|
integer
|
16
|
The maximum height for an application-supplied image for a choice element
|
|
CHOICE_WIDTH_SCROLL
|
integer
|
15
|
The width of the scrollbar in a pop-up choice
|
|
CHOICE_WIDTH_THUMB
|
integer
|
3
|
The width of the thumb of the scroll bar in a pop-up choice
|
|
CHOICE_HEIGHT_THUMB
|
integer
|
4
|
The height of the thumb of the scroll bar in a pop-up choice
|
|
CHOICE_PAD_H
|
integer
|
4
|
The horizontal padding (in pixels) to use between elements on the same line
|
|
CHOICE_PAD_V
|
integer
|
2
|
The vertical padding (in pixels) to use between elements on the same line
|
|
CHOICE_COLOR_FG
|
integer
|
0x000000
|
The foreground color for a pop-up choice
|
|
CHOICE_COLOR_BG
|
integer
|
0x000000
|
The background color for a pop-up choice
|
|
CHOICE_COLOR_BRDR
|
integer
|
0x003366
|
The border color for a pop-up choice
|
|
CHOICE_COLOR_BRDR_SHD
|
integer
|
0x8db0d9
|
The border shadow color for a pop-up choice
|
|
CHOICE_COLOR_SCROLL
|
integer
|
0x003366
|
The color of a scrollbar for a pop-up choice
|
|
CHOICE_COLOR_THUMB
|
integer
|
0x003366
|
The color of the scroll bar thumb for a pop-up choice
|
|
CHOICE_FONT
|
font
|
FontResources.PROP_P_M
|
The font to use for choice elements
|
|
CHOICE_FONT_FOCUS
|
font
|
FontResources.PROP_P_M
|
The font to use for the currently focused choice element
|
|
CHOICE_IMAGE_RADIO
|
composite
image
|
choice.image_radio
(not ROMized)
|
The pair of images for radio buttons
|
|
CHOICE_IMAGE_CHKBX
|
composite
image
|
choice.image_chkbx
(not ROMized)
|
The pair of images for checkboxes
|
|
CHOICE_IMAGE_BG
|
composite
image
|
choice.image_bg
(not ROMized)
|
The nine-piece image background for a popup choice group.
|
|
CHOICE_IMAGE_BTN_BG
|
composite
image
|
choice.image_btn_bg
(not ROMized)
|
The nine-piece image background to use to draw the popup button for a popup choice group.
|
|
CHOICE_IMAGE_BTN_ICON
|
image
|
choice.image_btn_icon
(not ROMized)
|
The image to use to indicate the drop-down nature of the popup choice, usually a down arrow
|
|
CHOICE_IMAGE_POPUP_BG
|
composite
image
|
choice.image_popup_bg
(not ROMized)
|
The nine-piece image background to use for the background of a popup choice window
|
Date Editor Properties
Skinning a date editor for use with adaptive user interface software requires you to reassign values to the properties listed in TABLE 4-10. This table contains the date editor property settings defined in the skin_constants.xml file and the values assigned to those properties in the skin.xml file.
TABLE 4-10 Date Editor Property Settings
|
Property (Key)
|
Type
|
Value
|
Description
|
|
DATEEDITOR_HEIGHT
|
integer
|
110
|
The height (in pixels) of the pop-up date editor
|
|
DATEEDITOR_HEIGHT_POPUPS
|
integer
|
73
|
The maximum height allowed for internal popups like month, year, hours, etc.
|
|
DATEEDITOR_WIDTH_D
|
integer
|
111
|
The width (in pixels) of the pop-up date editor in date mode
|
|
DATEEDITOR_WIDTH_T
|
integer
|
99
|
The width (in pixels) of the pop-up date editor in time mode
|
|
DATEEDITOR_WIDTH_DT
|
integer
|
167
|
The width (in pixels) of the popup date editor in date-time mode
|
|
DATEEDITOR_COLOR_BG
|
integer
|
0xFFEDA0
|
The background color of the pop-up editor if the background image cannot be found or loaded
|
|
DATEEDITOR_COLOR_POPUPS_BG
|
integer
|
0xF4DDD7
|
The background color for the pop-ups, such as hours, minutes, month, etc.
|
|
DATEEDITOR_COLOR_BRDR
|
integer
|
0x0D0D0A
|
The border color of the pop-up editor if the background image cannot be found or loaded
|
|
DATEEDITOR_COLOR_TRAV_IND
|
integer
|
0xFF7012
|
The color of the traverse indicator within the editor pop-up
|
|
DATEEDITOR_COLOR_CLK_LT
|
integer
|
0xFFFFFF
|
The color to draw the hands of the clock
|
|
DATEEDITOR_COLOR_CLK_DK
|
integer
|
0x9D7E4F
|
The shadow color to draw the hands of the clock.
|
|
DATEEDITOR_FONT_POPUPS
|
font
|
FontResources.PROP_P_S
|
The font to use for rendering options inside the pop-ups like hours, minutes, month, etc.
|
|
DATEEDITOR_IMAGE_BG
|
composite
image
|
dateeditor.image_bg
(not ROMized)
|
The nine-piece image background to use to draw the background of the pop-up editor.
|
|
DATEEDITOR_IMAGE_MON_BG
|
image
|
dateeditor.image_mon_bg
(not ROMized)
|
The background image fro the drop-down month selector
|
|
DATEEDITOR_IMAGE_YR_BG
|
image
|
dateeditor.image_yr_bg
(not ROMized)
|
The background image for the drop-down year selector
|
|
DATEEDITOR_IMAGE_CAL_BG
|
image
|
dateeditor.image_cal_bg
(not ROMized)
|
The background image for rendering the calendar
|
|
DATEEDITOR_IMAGE_DATES
|
image
|
dateeditor.image_dates
(not ROMized)
|
A single image that holds all the dates as graphics
|
|
DATEEDITOR_IMAGE_TIME_BG
|
image
|
dateeditor.image_time_bg
(not ROMized)
|
The background image for the drop-down hour-minute selected
|
|
DATEEDITOR_IMAGE_RADIO
|
composite
image
|
dateeditor.image_radio
(not ROMized)
|
Two radio button images for the am-pm setting
|
|
DATEEDITOR_IMAGE_AMPM
|
image
|
dateeditor.image_ampm
(not ROMized)
|
A single image that holds the graphics for the am-pm text
|
|
DATEEDITOR_IMAGE_CLOCK_BG
|
image
|
dateeditor.image_clock_bg
(not ROMized)
|
The background image for the clock
|
Date Field Properties
Skinning a date field for use with adaptive user interface software requires you to reassign values to the properties listed in TABLE 4-11. This table contains the date field property settings defined in the skin_constants.xml file and the values assigned to those properties in the skin.xml file.
TABLE 4-11 Date Field Property Settings
|
Property (Key)
|
Type
|
Value
|
Description
|
|
DATEFIELD_PAD_H
|
integer
|
3
|
The horizontal padding (in pixels) between the left and right borders of a date field and its contents
|
|
DATEFIELD_PAD_V
|
integer
|
2
|
The vertical padding (in pixels) between the top and bottom borders of a text component and its contents
|
|
DATEFIELD_BTN_BRDR_W
|
integer
|
3
|
The width (in pixels) of the line border around a pop-up button
|
|
DATEFIELD_FONT
|
font
|
FontResource.PROP_P_M
|
The font to use for the text in the date field
|
|
DATEFIELD_COLOR_FG
|
integer
|
0x000000
|
The foreground color for the date field
|
|
DATEFIELD_COLOR_BG
|
integer
|
0xC9E8FF
|
The background color for the date field
|
|
DATEFIELD_COLOR_BRDR
|
integer
|
0x0D3964
|
The border color for the date field
|
|
DATEFIELD_COLOR_BRDR_LT
|
integer
|
0x8DB0D9
|
The light line border color for a pop-up button
|
|
DATEFIELD_COLOR_BRDR_DK
|
integer
|
0x003366
|
The dark line border color for a popup button
|
|
DATEFIELD_COLOR_BRDR_SHD
|
integer
|
0x8db0d9
|
The border shadow color for the date field
|
|
DATEFIELD_IMAGE_BG
|
composite
image
|
datefield.image_bg
|
The nine-piece image background for the date field
|
|
DATEFIELD_IMAGE_BTN_BG
|
composite
image
|
datefield.image_btn_bg
|
The nine-piece image background for the pop-up button that holds the specific icon for the date field
|
|
DATEFIELD_IMAGE_ICON_DATE
|
image
|
datefield.image_icon_date
|
The icon for the pop-up button for a date-only field
|
|
DATEFIELD_IMAGE_ICON_TIME
|
image
|
datefield.image_icon_time
|
The icon for the pop-up button for a time-only date field
|
|
DATEFIELD_IMAGE_ICON_DATETIME
|
image
|
datefield.image_icon_datetime
|
The icon for the pop-up button for a date and time date field
|
Gauge Properties
Skinning a gauge for use with adaptive user interface software requires you to reassign values to the properties listed in TABLE 4-12. This table contains the gauge property settings defined in the skin_constants.xml file and the values assigned to those properties in the skin.xml file.
TABLE 4-12 Gauge Property Settings
|
Property (Key)
|
Type
|
Value
|
Description
|
|
GAUGE_ORIENT
|
integer
|
8
|
The orientation of the gauge
|
|
GAUGE_WIDTH
|
integer
|
137
|
The width of the gauge
|
|
GAUGE_HEIGHT
|
integer
|
27
|
The height of the gauge
|
|
GAUGE_METER_X
|
integer
|
24
|
The x-coordinate of the meter image for this gauge
|
|
GAUGE_MATER_Y
|
integer
|
0
|
The y-coordinate of the meter image for this gauge
|
|
GAUGE_INC_BTN_X
|
integer
|
114
|
The x-coordinate of the increase button for this gauge
|
|
GAUGE_INC_BTN_Y
|
integer
|
0
|
The y-coordinate of the increase button for the gauge
|
|
GAUGE_DEC_BTN_X
|
integer
|
0
|
The x-coordinate of the decrease button for the gauge
|
|
GAUGE_DEC_BTN_Y
|
integer
|
0
|
The y-coordinate of the decrease button for the gauge
|
|
GAUGE_VALUE_X
|
integer
|
88
|
The x-coordinate defining the upper left corner of the bounding box that contains the gauge's value
|
|
GAUGE_VALUE_Y
|
integer
|
6
|
The y-coordinate defining the upper left corner of the bounding box that contains the gauge's value
|
|
GAUGE_VALUE_WIDTH
|
integer
|
24
|
The maximum allowable width of the space available to render the value of the gauge
|
|
GAUGE_IMAGE_BG
|
image
|
gauge.image_bg
(not ROMized)
|
The image to be used for the background body of the gauge
|
|
GAUGE_IMAGE_MTR_EMPTY
|
image
|
gauge.image_mtr_empty
(not ROMized)
|
The image to be used for the meter of the gauge in an empty state
|
|
GAUGE_IMAGE_MTR_FULL
|
image
|
gauge.image_mtr_full
(not ROMized)
|
The image to be used for the meter of the gauge in a full state
|
|
GAUGE_IMAGE_INC_BTN
|
image
|
gauge.image_inc_btn
(not ROMized)
|
The image to be used for the increase button for the gauge
|
|
GAUGE_IMAGE_DEC_BTN
|
image
|
gauge.image_dec_btn
(not ROMized)
|
The image to be used for the decrease button for the gauge
|
|
GAUGE_IMAGE_VALUES
|
image
|
gauge.image_values
(not ROMized)
|
The image to be used to paint the value of the gauge in a numerical form
|
Image Item Properties
Skinning an image item for use with adaptive user interface software requires you to reassign values to the properties listed in TABLE 4-13. This table contains the image item property settings defined in the skin_constants.xml file and the values assigned to those properties in the skin.xml file.
TABLE 4-13 Image Item Property Settings
|
Property (Key)
|
Type
|
Value
|
Description
|
|
IMAGEITEM_COLOR_BG_LNK_FOC
|
integer
|
0xFFCC33
|
The background fill color of a hyperlink that has input focus
|
|
IMAGEITEM_COLOR_BG_BTN
|
integer
|
0xff0000
|
The background fill color of a button
|
|
IMAGEITEM_COLOR_BORDER_LT
|
integer
|
0x606060
|
The light line border color of a button that does not have an image background
|
|
IMAGEITEM_COLOR_BORDER_DK
|
integer
|
0xAFAFAF
|
The dark line border color of a button that does not have an image background
|
|
IMAGEITEM_PAD_LNK_H
|
integer
|
3
|
The padding between the sides of an image and its outer border when it is a hyperlink
|
|
IMAGEITEM_PAD_LNK_V
|
integer
|
3
|
The padding between the top and bottom of an image and its outer border when it is a hyperlink
|
|
IMAGEITEM_PAD_BTN_H
|
integer
|
4
|
The padding between the sides of an image and its outer border when it is a button
|
|
IMAGEITEM_PAD_BTN_V
|
integer
|
4
|
The padding between the top and bottom of an image and its outer border when it is a button
|
|
IMAGEITEM_VTN_BORDER_W
|
integer
|
3
|
The thickness of the line border drawn around the image when it is a button and its background image is not available
|
|
IMAGEITEM_IMAGE_LNK_H
|
image
|
imageitem.image_lnk_h
(ROMized)
|
The horizontal portion of the border graphic to draw around an image when it is a hyperlink
|
|
IMAGEITEM_IMAGE_LNK_V
|
image
|
imageitem.image_lnk_v
(ROMized)
|
The vertical portion of the border graphic to draw around an image when it is a hyperlink
|
|
IMAGEITEM_IMAGE_BUTTON
|
composite
image
|
imageitem.image_btn
(ROMized)
|
The nine-piece image background for an image that is a button
|
Progress Bar Properties
Skinning a progress bar for use with adaptive user interface software requires you to reassign values to the properties listed in TABLE 4-14. This table contains the progress bar property settings defined in the skin_constants.xml file and the values assigned to those properties in the skin.xml file.
TABLE 4-14 Progress Bar Property Settings
|
Property (Key)
|
Type
|
Value
|
Description
|
|
PBAR_ORIENT
|
integer
|
8
|
The orientation of the progress bar
|
|
PBAR_WIDTH
|
integer
|
168
|
The width of the progress bar
|
|
PBAR_HEIGHT
|
integer
|
22
|
The height of the progress bar
|
|
PBAR_METER_X
|
integer
|
36
|
The x-coordinate of the meter image for the progress bar
|
|
PBAR_METER_Y
|
integer
|
0
|
The y-coordinate of the meter image for the progress bar
|
|
PBAR_VALUE_X
|
integer
|
4
|
The x-coordinate defining the upper left corner of the bounding box that contains the progress bar's values
|
|
PBAR_VALUE_Y
|
integer
|
3
|
The y-coordinate defining the upper left corner of the bounding box that contains the progress bar's values
|
|
PBAR_VALUE_WIDTH
|
integer
|
32
|
The maximum allowable width of the space available to render the value of the progress bar as a percentage
|
|
PBAR_IMAGE_BG
|
image
|
pbar.image_bg
|
The image to be used for the background body of the progress bar
|
|
PBAR_IMAGE_MTR_EMPTH
|
image
|
pbar.image_mtr_empty
|
The image to be used for the meter of the progress bar in an empty state
|
|
PBAR_IMAGE_MTR_FULL
|
image
|
pbar.image_mtr_full
|
The image to be used for the meter of the progress bar in a full state
|
|
PBAR_IMAGE_VALUES
|
image
|
pbar.image_values
|
The image to be used to paint the value of the progress bar in a numerical form
|
|
PBAR_IMAGE_PERCENTS
|
image
|
pbar.image_prcnts
|
The image to be used to display a percentage sign
|
String Item Properties
Skinning a string item for use with adaptive user interface software requires you to reassign values to the properties listed in TABLE 4-15. This table contains the string item property settings defined in the skin_constants.xml file and the values assigned to those properties in the skin.xml file.
TABLE 4-15 String Item Property Settings
|
Property (Key)
|
Type
|
Value
|
Description
|
|
STRINGITEM_PAD_BUTTON_H
|
integer
|
6
|
The number of pixels between the sides of the button and its text, in button mode
|
|
STRINGITEM_PAD_BUTTON_V
|
integer
|
1
|
The number of pixels between the top and bottom of the button and its text, in button mode
|
|
STRINGITEM_BUTTON_BORDER_W
|
integer
|
3
|
The width in pixels of the line border to draw around the button, in button mode
|
|
STRINGITEM_COLOR_FG_LINK
|
integer
|
0x003399
|
The foreground text color of a hyperlink
|
|
STRINGITEM_COLOR_FG_LNK_FOC
|
integer
|
0x003399
|
The foreground text color of a hyperlink that has input focus
|
|
STRINGITEM_COLOR_BG_LNK_FOC
|
integer
|
0xFFCC3
|
The background fill color of a hyperlink that has focus
|
|
STRINGITEM_COLOR_FG_BTN
|
integer
|
0x000000
|
The foreground text color of a button
|
|
STRINGITEM_COLOR_BG_BTN
|
integer
|
0x7199E1
|
The background fill color of a button
|
|
STRINGITEM_COLOR_BORDER_LT
|
integer
|
0x606060
|
The light line border color for a button
|
|
STRINGITEM_COLOR_BORDER_DK
|
integer
|
0xAFAFAF
|
The dark line border color for a button
|
|
STRINGITEM_FONT
|
font
|
FontResources.PROP_P_M
|
The font to use for a plain StringItem
|
|
STRINGITEM_FONT_LNK
|
font
|
FontResources.PROP_P_M
|
The font to use for a hyperlink
|
|
STRINGITEM_FONT_BTN
|
font
|
FontResources.PROP_P_M
|
The font to use for a button
|
|
STRINGITEM_IMAGE_LNK
|
image
|
stringitem.image_lnk
(not ROMized)
|
The image to use to draw the link underline below a hyperlink
|
|
STRINGITEM_IMAGE_BTN
|
composite
image
|
stringitem.image_btn
(not ROMized)
|
The nine-piece image background to use for a button
|
Text Field Properties
Skinning a text field for use with adaptive user interface software requires you to reassign values to the properties listed in TABLE 4-16. This table contains the text field property settings defined in the skin_constants.xml file and the values assigned to those properties in the skin.xml file.
TABLE 4-16 Text Field Property Settings
|
Property (Key)
|
Type
|
Value
|
Description
|
|
TEXTFIELD_PAD_H
|
integer
|
3
|
The horizontal padding (in pixels) between the left and right borders of a text component and its contents
|
|
TEXTFIELD_PAD_V
|
integer
|
2
|
The vertical padding (in pixels) between the top and bottom borders of a text component and its contents
|
|
TEXTFIELD_BOX_MARGIN
|
integer
|
4
|
The size of the inset margin for a full-screen text box component
|
|
TEXTFIELD_WIDTH_CARET
|
integer
|
1
|
The width (in pixels) for the caret (input cursor) in a text input component
|
|
TEXTFIELD_SCRL_RATE
|
integer
|
250
|
For auto-scrolling text, the rate (in milliseconds) between updates of the scrolling text
|
|
TEXTFIELD_SCRL_SPD
|
integer
|
5
|
For auto-scrolling text, the number of pixels to shift the text in a single update
|
|
TEXTFIELD_COLOR_FG
|
integer
|
0x000000
|
The foreground color for the text component
|
|
TEXTFIELD_COLOR_BG
|
integer
|
0xFFFFFF
|
The background color for the text component
|
|
TEXTFIELD_COLOR_BRDR
|
integer
|
0x000000
|
The border color for the text component
|
|
TEXTFIELD_COLOR_BRDR_SHD
|
integer
|
0x8db0d9
|
The border shadow color for the text component
|
|
TEXTFIELD_COLOR_FG_UE
|
integer
|
0x5d5d5d
|
The foreground color for an uneditable text component
|
|
TEXTFIELD_COLOR_BG_UE
|
integer
|
0xc2c2c2
|
The background color for an uneditable text component
|
|
TEXTFIELD_COLOR_BRDR_UE
|
integer
|
0x000000
|
The border color for an uneditable text component
|
|
TEXTFIELD_COLOR_BRDR_SHD_UE
|
integer
|
0xc2c2c2
|
The border shadow color for an uneditable text component
|
|
TEXTFIELD_IMAGE_BG
|
composite
image
|
textfield.image_bg
(not ROMized)
|
The nine-piece image background for a text component
|
|
TEXTFIELD_IMAGE_BG_UE
|
composite
image
|
textfield.image_bg_ue
(not ROMized)
|
The nine-piece image background for an uneditable text component
|
Update Bar Properties
Skinning an update bar for use with adaptive user interface software requires you to reassign values to the properties listed in TABLE 4-17. This table contains the update bar property settings defined in the skin_constants.xml file and the values assigned to those properties in the skin.xml file.
TABLE 4-17 Update Bar Property Settings
|
Property (Key)
|
Type
|
Value
|
Description
|
|
UPDATEBAR_WIDTH
|
integer
|
150
|
The width of an incremental updating gauge
|
|
UPDATEBAR_HEIGHT
|
integer
|
25
|
The height of an incremental updating gauge
|
|
UPDATEBAR_NUM_FRAMES
|
integer
|
7
|
The number of frames that contribute to the animation of the incremental updating gauge
|
|
UPDATEBAR_FRAME_X
|
integer
|
0
|
The x-coordinate of the animation region of the incremental updating gauge
|
|
UPDATEBAR_FRAME_Y
|
integer
|
0
|
The y-coordinate of the animation region of the incremental updating gauge
|
|
UPDATEBAR_FRAME_SEQU
|
integer
sequence
|
1,2,3,4,5,6,5,4,3,2
|
The sequence for animating frames in the incremental updating gauge
|
|
UPDATEBAR_IMAGE_BG
|
image
|
updatebar.image_bg
(not ROMized)
|
The image to be used for the background body of the incremental updating gauge
|
|
UPDATEBAR_IMAGE_FRAME
|
composite
image
|
updatebar.image_frame
(not ROMized)
|
All the images (frames) that contribute to the animation of the incremental updating gauge
|
Input Mode Indicator Properties
Skinning the input mode Indicator for use with adaptive user interface software requires you to reassign values to the properties listed in TABLE 4-18. This table contains the input mode Indicator property settings defined in the skin_constants.xml file and the values assigned to those properties in the skin.xml file.
TABLE 4-18 Input Mode Indicator Property Settings
|
Property (Key)
|
Type
|
Value
|
Description
|
|
INPUT_MODE_MARGIN
|
integer
|
3
|
The text margin of the Indicator (in pixels)
|
|
INPUT_MODE_COLOR_BG
|
integer
|
0xA3E2F8
|
The background fill color if the background image isn't specified or can't be loaded
|
|
INPUT_MODE_COLOR_FG
|
integer
|
0x000000
|
The foreground color for rendering text in the Indicator
|
|
INPUT_MODE_COLOR_BDR
|
integer
|
0x336699
|
The background color of the Indicator
|
|
INPUT_MODE_FONT
|
integer
|
FontResources.SYS_B_S
|
The font used to render text in the Indicator
|
|
INPUT_MODE_IMAGE_BG
|
composite image (3 pieces)
|
(no assigned value)
(not ROMized)
|
The images used to render a background for the Indicator. If no image is specified or can't be loaded, a solid fill color is used.
|
| Skin Author's Guide to Adaptive User Interface Technology
|
05-2007
|
|
Copyright © 2007, Sun Microsystems, Inc. All rights reserved. SUN PROPRIETARY/CONFIDENTIAL.