net.rim.device.api.system
Interface GlobalEventListener

All Known Implementing Classes:
DatagramTransportBase

public interface GlobalEventListener

The listener interface for receiving global events.

Arbitrary applications may use global events for inter-process communication (IPC). The BlackBerry OS can also generate global events, such as those defined by the ServiceBook API. Visit www.blackberry.com/go/devguides to read more on ServiceBook global events.

To receive a global event, an application must implement the GlobalEventListener interface and implement the GlobalEventListener.eventOccurred() method, which is invoked when a global event occurs. In its implementation of eventOccurred(), the application specifies which actions to perform when a global event is received.

Register the GlobalEventListener by invoking the Application.addGlobalEventListener(GlobalEventListener) method.

Example:

When the time zone changes, the system sends out a global event message to the applications. To catch it, implement the GlobalEventListener interface and register the listener by calling Application.addGlobalEventListener().

Your eventOccurred() method should look similar to this:
 public void eventOccurred( long guid, int data0, int data1, Object object0, Object object1 )
 {
     if( guid == DateTime.GUID_TIMEZONE_CHANGED )
     {
         _cal.setTimeZone( TimeZone.getDefault() );
     }
 }
 

For more information, visit www.blackberry.com/go/developerkb to read article DB-00469.

See Also:
Application.addGlobalEventListener(GlobalEventListener), ApplicationManager.postGlobalEvent()

Method Summary
 void eventOccurred(long guid, int data0, int data1, Object object0, Object object1)
          Invoked when the specified global event occurred.
 



Method Detail

eventOccurred

void eventOccurred(long guid,
                   int data0,
                   int data1,
                   Object object0,
                   Object object1)
Invoked when the specified global event occurred.

The eventOccurred() method provides two object parameters and two integer parameters for supplying details about the event itself. The developer determines how the parameters will be used.

For example, if the event corresponded to sending or receiving a mail message, the object0 parameter might specify the mail message itself, while the data0 parameter might specify the identification details of the message, such as an address value.

Parameters:
guid - The GUID of the event.
data0 - Integer value specifying information associated with the event.
data1 - Integer value specifying information associated with the event.
object0 - Object specifying information associated with the event.
object1 - Object specifying information associated with the event.





Copyright 1999-2011 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Java is a trademark of Oracle America Inc. in the US and other countries.
Legal