Welcome!

Welcome to the official BlackBerry Support Community Forums.

This is your resource to discuss support topics with your peers, and learn from each other.

inside custom component

Java Development

System Global Events

by BlackBerry Development Advisor ‎02-16-2010 10:39 AM - edited ‎02-17-2010 12:12 PM (3,701 Views)

Summary


This article applies to BlackBerry® wireless devices based on Java™.




Description


An application can be notified of certain system events that occur on the BlackBerry device through the use of the net.rim.device.api.system.GlobalEventListener interface. Many of these events have been exposed through other application programming interface (API), but the GlobalEventListener capability provides a direct mechanism for receiving these events. This article provides a list and explanation of many of the global events provided on the BlackBerry Device Software 4.1 that might be useful to third-party developers. It is important to understand that leveraging the GlobalEventListener capability takes additional resources due to the large number of global events that are issued in the system. As such, developers need to be very careful with the implementation of the eventOccurred method to make sure that it is as efficient as possible. Additionally, applications should only register as a GlobalEventListener when running and actively requiring this capability. Applications can also use the GlobalEventListener capability for inter-process communication in their own application. For more information on sending and listening for global events, see here.


Existing Global Events in BlackBerry Device Software 4.1


net.rim.device.api.i18n.DateFormat.GUID_DATE_FORMAT_CHANGED: GUID for the global event sent when the default date format changes.


net.rim.device.api.util.DateTimeUtilities.GUID_DATE_CHANGED: GUID for the global event sent when the date changes.


net.rim.device.api.util.DateTimeUtilities.GUID_TIMEZONE_CHANGED: GUID for the global event sent when the timezone changes.


net.rim.device.api.i18n.Locale.Locale.GUID_INPUT_LOCALE_CHANGED: GUID for global event sent when the current input locale changes.


net.rim.device.api.i18n.Locale.Locale.GUID_LOCALE_CHANGED: GUID for global event sent when the current locale changes.


net.rim.device.api.itpolicy.ITPolicy.GUID_IT_POLICY_CHANGED: The GUID for the global event sent when the IT Policy changes.


net.rim.device.api.itpolicy.ITPolicy.GUID_IT_POLICY_CHANGED_LOCKED_HANDHELD: The GUID for the global event sent when the IT Policy changes and device locking is required.


net.rim.device.api.lowmemory.LowMemoryManager.GUID_FLASH_LOW: The GUID of the global event, posted by the system, to notify the LowMemoryManager that the system is low on memory.


net.rim.device.api.ui.Font.GUID_FONT_CHANGED: The GUID for the global event sent when the system font changes.


net.rim.device.api.servicebook.ServiceBook.GUID_SB_ADDED: The GUID for the global event sent when a service book is added.


net.rim.device.api.servicebook.ServiceBook.GUID_SB_BR_END: The GUID for the global event sent when service book backup-restore ends.


net.rim.device.api.servicebook.ServiceBook.GUID_SB_BR_START: The GUID for the global event sent when service book backup-restore starts.


net.rim.device.api.servicebook.ServiceBook.GUID_SB_CHANGED: The GUID for the global event sent when a service book is changed.


net.rim.device.api.servicebook.ServiceBook.GUID_SB_OTA_SWITCH: The GUID for the global event sent when all service records are inserted due to a move BlackBerry Enterprise Server command OTA.


net.rim.device.api.servicebook.ServiceBook.GUID_SB_OTA_UPDATE: The GUID for the global event sent when all service records are updated for a UID OTA.


net.rim.device.api.servicebook.ServiceBook.GUID_SB_POLICY_CHANGED: The GUID for the global event sent when the service book responds to an IT Policy changed event.


net.rim.device.api.servicebook.ServiceBook.GUID_SB_REMOVED: The GUID for the global event sent when a service book is removed.


net.rim.device.api.io.DatagramStatusListener.GUID_GME_CRYPTO_FAILURE: The GUID for the global event sent when a decryption error occurs when trying to decrypt the incoming datagram.


Note: GUID stands for Global Unique Identifier.

Contributors
Users Online
Currently online: 3 members 957 guests
Please welcome our newest community members: