Chapter 3 CiscoIPPhone XML Objects

Application Event Handlers

Attribute

Description

 

 

appID

Identifies the application to which this displayable XSI

 

object belongs. The format of the appID attribute should

 

be in the format vendor/product, such as Cisco/Unity,

 

but this syntax is not enforced, and the application can

 

assign any unique identifier.

 

 

onAppFocusLost

Invoked when the application loses focus, if:

 

The application’s context has lost focus, or

 

The application was navigated away from, either

 

directly by the user, or programmatically by a refresh

 

header or HTTP push.

 

Note If a Notify URI is used as the event handler, a

 

notification is sent with this default data:

 

<notifyApplicationEvent appId="appId"

 

type="focusLost"/>

 

 

onAppFocusGained

Invoked when the application gains focus, if:

 

The application is Active and the application’s

 

context has gained focus, or

 

The application was navigated to, either directly by

 

the user, or by a refresh header or HTTP push.

 

Note If a Notify URI is used as the event handler, a

 

notification is sent with this default data:

 

<notifyApplicationEvent appId="appId"

 

type="focusGained"/>

 

 

onAppMinimized

Invoked when the application is minimized.

 

An application can only be minimized programmatically

 

by a call to App:Minimize, but this invocation could occur

 

by direct action of the user (from a softkey invocation, for

 

example) or from the application via a push request.

 

<notifyApplicationEvent appId="appId"

 

type="minimized"/>

 

 

onAppClosed

Invoked whenever the application closes, if:

 

The application's context is closed which will, in turn,

 

close all applications in its stack, or

 

The application no longer exists on the context’s URL

 

stack because it was navigated out of, or because it

 

was pruned from the URL stack (stack size exceeded).

 

Note This event handler cannot contain HTTP or

 

HTTPS URLs.

 

Note If a Notify URI is used as the event handler, a

 

notification is sent with this default data:

 

<notifyApplicationEvent appId="appId"

 

type="closed"/>

 

 

 

 

Cisco Unified IP Phone Services Application Development Notes

 

 

 

 

 

 

OL-20949-01

 

 

3-23

 

 

 

 

 

Page 41
Image 41
Cisco Systems OL-20949-01 manual Attribute Description