Table of Contents
Advertisement
Chapter 2
CiscoIPPhone XML Objects
XML Object Definitions
Menu items in the graphic menu have a name, like the text menu counterparts. Although the name does
not display to the user, it still performs a function. The name of the menu item provides the default title
that is used when the URL for the chosen item is loaded. If the loaded page has a title of its own, the
phone uses that title instead.
The XML tags in
use the tag definitions for
and
.
GraphicMenu
CiscoIPPhoneImage
CiscoIPPhoneMenu
Although the semantics of the tags are identical, you can have only 12
objects in a
MenuItem
object. See
"CiscoIPPhoneMenu"
and
"CiscoIPPhoneImage"
for detailed
CiscoIPPhoneGraphicMenu
descriptions.
CiscoIPPhoneGraphicFileMenu
Some of the Cisco Unified IP Phone models, such as the Cisco Unified IP Phone 7970G and
Cisco IP Communicator, have pointer devices. The Cisco Unified IP Phone 7970G uses a touchscreen
overlay on the display, and the PC-based Cisco IP Communicator uses the standard Windows mouse
pointer.
Because these devices can receive and process "pointer" events, a
CiscoIPPhoneGraphicFileMenu
object exposes the capability to application developers. The CiscoIPPhoneGraphicFileMenu behaves
similar to the CiscoIPPhoneGraphicMenu, in that a group of options are presented by an image. When
one of those objects is selected, a URL action initiates. However, the new FileMenu does not use the
keypad, but uses rectangular touch areas. This rectangular touch area,
, is defined by
<TouchArea>
coordinates relative to the upper-left corner of the Services display. The (X1,Y1) points specify the
upper-left corner of the
and (X2,Y2) specify the lower-right corner of the
.
<TouchArea>,
<TouchArea>
Figure 2-5
shows the display of the CiscoIPPhoneGraphicFileMenu.
Figure 2-5
CiscoIPPhoneGraphicFileMenu
If the coordinates that are supplied in
tag exceed the dimensions of the phone display, the
<TouchArea>
rectangle will be "clipped" to fit. See
Table
2-2,
"Cisco Unified IP Phones Display Image
<TouchArea>
Sizes and Color Depths"
for a listing of usable display resolutions for each phone model.
The
rectangles are allowed to overlap, and the first match is always taken. This allows a
<TouchArea>
sense of Z-order for images where smaller touchable objects can be overlaid on top of larger ones. In
this case, the smaller object
must appear before the larger one in the
<MenuItem>
object.
<CiscoIPPhoneGraphicFileMenu>
The requirements for the PNG image referenced by the
tag match those that the
<URL>
CiscoIPPhoneImageFile object uses.
Definition
<CiscoIPPhoneGraphicFileMenu>
Cisco Unified IP Phone Services Application Development Notes
2-11
OL-18696-01
Advertisement
Table of Contents
Troubleshooting
