Specifications

3-8

Cisco Unified IP Phone Services Application Development Notes

OL-22505-01

Chapter 3 CiscoIPPhone XML Objects

XML Object Definitions

<Data>Packed Pixel Data</Data>

<Position>Numerical position of the soft key</Position>

</SoftKeyItem>

</CiscoIPPhoneImage>

WindowMode is an optional attribute used to set the width of an XSI application window. This attribute

is supported on the 7941, 7942, 7945, 7961, 7962, 7965, 7970, 7971, and 7975 phone models

The WindowMode attribute accepts either of the following two values:

• Normal—(Default value) The application window is in the normal width mode. See Figure 3-3.

• Wide—The application window is in the full width mode that is, the window expands to the

complete phone screen width. The wide mode supports a maximum width of 320 pixel for an image.

See

Figure 3-3.

The WindowMode attribute name and value are case sensitive. If the attribute name is wrong then it is

ignored and the default window width is set. If the attribute value is wrong then the parser reports XML

parse error and the XSI is rejected.

The WindowMode attribute is ignored on phones that does not support this feature. In such cases the

window remains in the original width. The absence of this attribute is treated as the Normal mode in

phones that support this feature.

For examples on the useage of the WindowMode attribute, see Example 2, page 3-9.

Figure 3-3 WindowMode

The Title and Prompt elements serve the same purpose as they do in the other CiscoIPPhone XML

objects. The

Title displays at the top of the page, and the Prompt displays at the bottom.

Use LocationX and LocationY to position the graphic on the phone display. Position the upper, left corner

of the graphic at the pixel defined by these two parameters. Setting the X and Y location values to (0, 0)

positions the graphic at the upper, left corner of the display. Setting the X and Y location values to (-1,

-1) centers the graphic in the services pane of the phone display.

Use Width and Height to size the graphic. If the values do not match with the pixel stream specified in

the

Data field, results will be unpredictable incorrect.

Depth specifies the number of bits per pixel. Cisco Unified IP Phones support a maximum value of 2. A

bit depth of 1 is black and white.