Cisco OL-20949-01 - Manual (Page 41)

3-23
Cisco Unified IP Phone Services Application Development Notes
OL-20949-01
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"/>