CiscoIPPhoneIconMenu | Cisco Systems OL-20949-01 manual

Chapter 3 CiscoIPPhone XML Objects

XML Object Definitions

Figure 3-5shows 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.

	Cisco Unified IP Phone Services Application Development Notes
3-12	OL-20949-01

Image 30

Cisco Systems OL-20949-01 manual CiscoIPPhoneIconMenu, 5shows the display of the CiscoIPPhoneGraphicFileMenu

Contents

Americas Headquarters Text Part Number OL-20949-01 Copyright 2004-2009 Cisco Systems, Inc. All rights reserved N T E N T S Iii Display Init Benefits Revision History PrefaceOverview Audience Organization Chapter DescriptionViii Cisco Unified IP Phone 7900 Series Cisco Unified Communications Manager AdministrationRelated Documentation Cisco Unified Communications Manager Business Edition Cisco Product Security Overview Document ConventionsConvention Indication Page Xii Overview 1shows a sample text menu Graphic Menu on a Cisco Unified IP Phone Sample Page OL-20949-01 New and Changed Information New Information for Cisco Unified Communications Manager OL-20949-01 CiscoIPPhone XML Objects Understanding Object Behavior 1shows the supported XML objects for this release XML Object Definitions CiscoIPPhoneMenu CiscoIPPhoneText Definition CiscoIPPhoneInput Sample User Input Display CiscoIPPhoneDirectory InputFlag Description CiscoIPPhoneImage Custom Directories Packed Pixel Translation Example Example Resolution1CiscoIPPhoneImageFile Model Monochrome Cisco Unified IP Phone 7970G Image File Display CiscoIPPhoneGraphicMenu CiscoIPPhoneGraphicFileMenu CiscoIPPhoneIconMenu 5shows the display of the CiscoIPPhoneGraphicFileMenu 6shows an IconMenu on a Cisco Unified IP Phone CiscoIPPhoneIconFileMenu CiscoIPPhoneStatus Dynamic Sizing of the Application Status Window CiscoIPPhoneStatus Phone Models Area Width Area Height 7940G, 7960G 7962G, 7965G 7970G/7971G-GE, 7975G, IP Communicator Text Area Size Phone Models WxH No Timer WxH 7940G, 7960GCiscoIPPhoneStatusFile 7962G, 7965G CiscoIPPhoneExecute Behavior Description CiscoIPPhoneError Custom SoftkeysCiscoIPPhoneResponse XML Considerations SoftKeyItem NameDisplayed sofkey label/Name Mandatory Escape Sequences XML EncodingCharacter Name Escape Sequence Application Event Handlers Supported UnsupportedAttributes Attribute Description Event Handler Schema Component APIs Application Management APIRTP Streaming API RTP Streaming Schema Interaction Rules with Legacy RTP URI Streams XscomplexType Xsall Error Schema Start Media Errors and ResponsesExamples Stop Media Applicable Condition Methods Http Result Code Type Data 7942G, 7962G 7906G 7945G, 7965G 7970G 6921 Internal URI FeaturesSupported URIs by Phone Model 7905G 7911G 7921G 7940G 7971G-GE 6941 Device Control URIs KeyURI Format KeyDirectories Phone Unsupported Models Description and Alternatives Display URI XML Displayable Object URIs SoftKey Select Exit Update Submit Search Cancel Next Dial QueryStringParam Internal URI Features XML Displayable Object URIs Multimedia URIs RTP StreamingInteraction with Call Streaming RTPRx URI Formats RTPTx Play VibrateInteraction with Incoming Calls Telephony URIs Dial EditDial SendDigits Error and Response Condition Status Data Application Management URIs InitNotify Called from SoftKey, with credentials, with data Application Called from SoftKey, no credentials, no data AppactionpriorityidleTimerapplicationId Error and Response Http Requests and Header Settings Http Client Requests Http GETHttp Server Requests Http Post Http Header Settings See the Http Refresh Setting section on page 6-3section Http Refresh Setting Refresh Display Sample Content Expiration Header Setting Mime Type and Other Http Headers Set-Cookie Header Setting Http Encoding Header Setting Accept-Language Identifying the Capabilities of IP Phone Clients CiscoIPPhoneModelNameCiscoIPPhoneDisplay Accept Header CiscoIPPhoneSDKVersion Accessing IP Phone Information Html URL XML URL OL-20949-01 Troubleshooting Cisco Unified IP Phone Service Applications Troubleshooting TipsXML Parsing Errors Error Messages Cisco IP Phone Services Software Development Kit SDK SDK Components OL-20949-01 Sample Services Requirements \CiscoIpServices\Tools OL-20949-01 IP Phone Service Administration Subscription Accessing Phone Service Administration Adding a Phone Service Field Description Defining IP Phone Service Parameters Field Description Service Parameter Information User Service Subscription DeviceListX Report 10-1 Integration Considerations and Interoperability BenefitsRestrictions Performance and Scalability Supported Platforms Related Features and TechnologiesSecurity Prerequisites Field Name Description Troubleshooting DeviceListX ReportsError Codes 10-4 Determining Problems With the Interface Procedure10-5 10-6 CiscoIPPhone XML Object Quick Reference Object Definition Appendix a CiscoIPPhone XML Object Quick Reference IndexA unique index from 0 to 9/Index OL-20949-01 Cisco Unified IP Phone Services XML Schema File Updated XML Parser and Schema Enforcement CiscoIPPhone.xsd Xsdelement name=Name minOccurs=0 xsdsimpleType Xsdrestriction XsdsimpleType XsdsimpleType xsdrestriction base=xsdstring XsdcomplexType name=CiscoIPPhoneSoftKeyType xsdsequence Xsdelement name=Title minOccurs=0 xsdsimpleType Xsdrestriction XsdsimpleType Xsdattribute XsdcomplexType Xsdelement name=CiscoIPPhoneDirectory xsdcomplexType Xsdelement name=CiscoIPPhoneImageFile xsdcomplexType Xsdelement name=CiscoIPPhoneIconMenu xsdcomplexType Xsdelement name=CiscoIPPhoneGraphicFileMenu xsdcomplexType Xsdsequence Xsdelement name=Text minOccurs=0 xsdsimpleType Xsdsequence XsdcomplexType Xsdelement Numerics IN-1 Html URL IN-2 IN-3 XML URL IN-4