Specifications

3-20

Cisco Unified IP Phone Services Application Development Notes

OL-22505-01

Chapter 3 CiscoIPPhone XML Objects

XML Object Definitions

This icon menu is similar to CiscoIPPhoneMenu, but it uses color PNG icons rather than grayscale CIP

icons. 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 can use icons to indicate priority (see

Figure 3-16).

Icons in the CiscoIPPhoneIconFileMenu object have a maximum width of 18 pixels and a maximum

height of 18 pixels. Instead of using the

<Data> tag to embed the image data into the <IconItem> tag,

this object uses a

<URL> tag to point to the PNG image file to be used for that icon.

Figure 3-16 CiscoIPPhoneIconFileMenu Object Display Sample

Definition

<Title>Title text goes here</Title>

<Prompt>Prompt text goes here</Prompt>

<IconIndex>Indicates what IconItem to display</IconIndex>

<URL>The URL associated with the menu item</URL>

</MenuItem>

<Index>A unique index from 0 to 9</Index>

<URL>location of the PNG icon image</URL>

</IconItem>

</CiscoIPPhoneIconFileMenu>

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.

Enhanced Icon Menu Support

The Enhanced Icon Menu Support feature extends the existing CiscoIPPhoneIconFileMenu XML object

by allowing:

• An icon in its <Title> element.

• Internal phone firmware icons, like security state or call state icons, in its <MenuItems> and <Title>

elements.

The following topics are covered in this section:

• Supported IP Phones and Codecs, page 3-21

• Changes in XML Object, page 3-22