Filter
Top Products
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.