Specifications

3-16
Cisco Unified IP Phone Services Application Development Notes
OL-22505-01
Chapter 3 CiscoIPPhone XML Objects
XML Object Definitions
Figure 3-11 WindowMode Attribute Set to Wide
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,
<TouchArea>, is defined by
coordinates relative to the upper-left corner of the Services display. The (X1,Y1) points specify the
upper-left corner of the
<TouchArea>, and (X2,Y2) specify the lower-right corner of the <TouchArea>.
Figure 3-12 shows the display of the CiscoIPPhoneGraphicFileMenu.
Figure 3-12 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.