Chapter 3 CiscoIPPhone XML Objects

XML Object Definitions

Figure 3-5shows the display of the CiscoIPPhoneGraphicFileMenu.

Figure 3-5 CiscoIPPhoneGraphicFileMenu

If the coordinates that are supplied in <TouchArea> tag exceed the dimensions of the phone display, the <TouchArea> rectangle will be “clipped” to fit. See Table 3-2, “Cisco Unified IP Phones Display Image Sizes and Color Depths” for a listing of usable display resolutions for each phone model.

The <TouchArea> rectangles are allowed to overlap, and the first match is always taken. This allows a sense of Z-order for images where smaller touchable objects can be overlaid on top of larger ones. In this case, the smaller object <MenuItem> must appear before the larger one in the

<CiscoIPPhoneGraphicFileMenu> object.

The requirements for the PNG image referenced by the <URL> tag match those that the

CiscoIPPhoneImageFile object uses.

Definition

<CiscoIPPhoneGraphicFileMenu> <Title>Image Title goes here</Title> <Prompt>Prompt text goes here</Prompt> <LocationX>Horizontal position of graphic</LocationX> <LocationY>Vertical position of graphic</LocationY> <URL>Points to the PNG background image</URL> <MenuItem>

<Name>Same as CiscoIPPhoneGraphicMenu</Name> <URL>Invoked when the TouchArea is touched</URL>

<TouchArea X1="left edge" Y1="top edge" X2="right edge" Y2="bottom edge"/> </MenuItem>

</CiscoIPPhoneGraphicFileMenu>

Note The 6900 series IP phones does not display the Title and Prompt menu fields at the same time. If both Title and Prompt fields are defined at the same time, then these phones display only the Prompt field.

CiscoIPPhoneIconMenu

Icon menus serve the same purpose as text menus: they allow a user to select a URL from a list. Use icon menus in situations when you want to provide additional visual information to the user to show the state or category of an item. For example, you include a read and unread icon in a mail viewer. You can use the icons can to convey the message state.

 

Cisco Unified IP Phone Services Application Development Notes

3-12

OL-20949-01

Page 30
Image 30
Cisco Systems OL-20949-01 manual CiscoIPPhoneIconMenu, 5shows the display of the CiscoIPPhoneGraphicFileMenu