Ciscoipphoneiconmenu – Cisco OL-20949-01 User Manual

Page 30

Advertising
background image

3-12

Cisco Unified IP Phone Services Application Development Notes

OL-20949-01

Chapter 3 CiscoIPPhone XML Objects

XML Object Definitions

Figure 3-5

shows 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.

Advertising