Obtain and enter the button properties – Sun Microsystems Computer Accessories User Manual
Page 24
10
Wireless Toolkit Basic Customization Guide • December 2003
■
Bottom right coordinate - the bottom right coordinate of the screen area:
(
screen.
x+
screen.
width,
screen.
y+
screen.
height).
Customization of the display area will be available in future versions of the
Wireless Toolkit.
Obtain and Enter the Button Properties
1. By measuring the image file, obtain the button properties.
A button on the emulated device is defined in the main device property file by
name and screen location in the following form:
button.<
button_name
> =
x
,
y
,
width
,
height
where the parameters are as follows:
■
button_name: One of the button names defined for the
DefaultColorPhone
: 0,
1, 2, 3, 4, 5, 6, 7, 8,9, POUND, ASTERISK, SEND, END, LEFT, RIGHT, UP,
DOWN, SELECT, SOFT1, SOFT2 and POWER. For information about how to use
additional button names, see
■
x: The x-coordinate of the left edge of the button image, in pixels relative to the
left edge of the device image
■
y: The y-coordinate of the top edge of the button image, in pixels relative to the
top edge of the device image
■
width: The width of the button image, in pixels
■
height: The height of the button image, in pixels.
The button location and dimensions are used for two purposes:
■
To define the active region in which a mouse click is interpreted as a button
press.
■
To define the region of the device image that is used to show graphic effects on
device buttons.
The region for each button should be defined to be large enough to cover the
button's area on all three device images. However, be careful not to allow the
buttons' regions to overlap each other.
The button coordinates are shown in