Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
postGlobalEvent(int processId,
long guid,
int data0,
int data1,
Object object0,
Object object1)
Posts a global event with additional data and attachments to the
specified process.
boolean
postGlobalEvent(long guid)
Posts a global event to all applications in the system.
boolean
postGlobalEvent(long guid,
int data0,
int data1)
Posts a global event with additional data to all applications in the system.
abstract boolean
postGlobalEvent(long guid,
int data0,
int data1,
Object object0,
Object object1)
Posts a global event with additional data and attachments to all
applications in the system.
abstract void
requestForeground(int processId)
Sends a foreground request to application with specified process ID.
abstract void
requestForegroundForConsole()
Requests that the console process (usually the ribbon) be notified that it should
bring itself to the foreground.
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
getForegroundProcessId
public abstract int getForegroundProcessId()
Retrieves the process ID of the foreground process.
Parameters:
processId - Process ID of the application which is currently in the foreground;
-1 if there is no foreground application.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
getNextAlarm
public abstract long getNextAlarm(int powerOnBehavior)
Get the next alarm based on the power on behavior
Parameters:
powerOnBehavior - the ApplicationDescriptor power On Behaviour filter alarms by.
Returns:
Reference to the system's application manager.
Since:
JDE 4.1.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Retrieves the process ID for specified descriptor's application.
Parameters:
descriptor - Descriptor for the application in question.
Returns:
ID for process hosting descriptor's application; -1 if
application has no process (i.e. is not running).
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Retrieves descriptors for the visible, running applications.
Returns:
Array of descriptors for the visible (foregroundable), running
applications.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
inStartup
public abstract boolean inStartup()
Determines if the device is in the process of starting up. During startup,
all threads must quiesce in order for the startup process to move on to the
next startup tier.
Returns:
True if the device is in the process of starting up.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Determines if an application descriptor is the descriptor of the console process.
Parameters:
descriptor - The descriptor to check.
Returns:
true if the specified descriptor matches the console process' descriptor;
returns false otherwise or if descriptor==null.
Since:
JDE 4.2.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
isSystemLocked
public abstract boolean isSystemLocked()
Determines if the system is currently locked.
Returns:
True if the system is currently locked.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Launches an application with provided URL parameter.
This method launches an application with an URL of the following
form:
module.name?param¶m¶m...
or
module?param¶m¶m...
if there is only a single entry point in the module.
Parameters:
url - URL which can be in any form and is passed in the arguments to
main.
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
lockSystem
public abstract void lockSystem(boolean force)
Locks the system.
Parameters:
force - If true, force the system to be locked even if security is
disabled. This is used when the IT Policy changes.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
postGlobalEvent
public abstract boolean postGlobalEvent(int processId,
long guid,
int data0,
int data1,
Object object0,
Object object1)
Posts a global event with additional data and attachments to the
specified process.
To receive and handle such events, the application must register a
GlobalEventListener.
Parameters:
processId - Process ID of the application to receive the event.
guid - The GUID of the event.
data0 - Additional information associated with the event.
data1 - Additional information associated with the event.
object0 - Additional information associated with the event.
object1 - Additional information associated with the event.
Returns:
True if the event was successfully posted; otherwise, false.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
postGlobalEvent
public final boolean postGlobalEvent(long guid)
Posts a global event to all applications in the system.
To receive and handle such events, an application must register a
GlobalEventListener.
Parameters:
guid - The GUID of the event.
Returns:
True if the event was successfully posted; otherwise, false.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
postGlobalEvent
public final boolean postGlobalEvent(long guid,
int data0,
int data1)
Posts a global event with additional data to all applications in the system.
To receive and handle such events, an application must register a
GlobalEventListener.
Parameters:
guid - The GUID of the event.
data0 - Additional information associated with the event.
data1 - Additional information associated with the event.
Returns:
True if the event was successfully posted; otherwise, false.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
postGlobalEvent
public abstract boolean postGlobalEvent(long guid,
int data0,
int data1,
Object object0,
Object object1)
Posts a global event with additional data and attachments to all
applications in the system.
To receive and handle such events, an application must register a
GlobalEventListener.
Parameters:
guid - The GUID of the event.
data0 - Additional information associated with the event.
data1 - Additional information associated with the event.
object0 - Additional information associated with the event.
object1 - Additional information associated with the event.
Returns:
True if the event was successfully posted; otherwise, false.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
requestForeground
public abstract void requestForeground(int processId)
Sends a foreground request to application with specified process ID.
Parameters:
processId - Process ID for the application to receive a foreground request.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
requestForegroundForConsole
public abstract void requestForegroundForConsole()
Requests that the console process (usually the ribbon) be notified that it should
bring itself to the foreground.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Creates a new process to run an application and ask it to foreground itself.
Invoke this method to create a new process and invoke the exported
main() method in the specified descriptor. This method then asks the
process to foreground itself (which it may or may not do). If a process
has already been created for your descriptor, then this method sends that
process a foreground request.
Parameters:
descriptor - Descriptor of application to start.
Returns:
Process ID for the application's new process; if the application
already has a running process, this will be the ID for that process.
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Invoke this method to create a new process and invoke the exported
main() method in the specified descriptor. If you pass true for the
grabForeground parameter, then this method also asks the process to
foreground itself (which it may or may not do). If a process has already
been created for your descriptor, and you pass true for the
grabForeground parameter, then this method sends that process a
foreground request.
Parameters:
descriptor - Descriptor of application to start.
grabForeground - If true, this method prompts the application to
foreground itself.
Returns:
Process ID for the application's new process; if the application
already has a running process, this will be the ID for that process.
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
scheduleApplication
public abstract boolean scheduleApplication(ApplicationDescriptor descriptor,
long time,
boolean absolute)
Schedules an application to run at a specific time.
If the application is already scheduled to run at a particular time,
then this method updates the schedule with your specified time. Note that
the application scheduler has a resolution of one minute. Times are
rounded down to the nearest minute.
If the specified time is absolute and has already occurred, the
application will not be scheduled.
Parameters:
descriptor - Descriptor of application to start.
time - Time at which to run the application; if a negative value,
remove this application from the schedule.
absolute - If true, then the time parameter represents the number of
milliseconds since device's origin time (midnight, January 1, 1970 UTC);
otherwise, it represents the number of milliseconds since midnight local time.
Returns:
True if the application was scheduled successfully; otherwise, false.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
setCurrentPowerOnBehavior
public abstract void setCurrentPowerOnBehavior(int powerOnBehavior)
Set the Power On Behavior for scheduled applications
Parameters:
powerOnBehavior - the ApplicationDescriptor power On Behaviour to use.
Since:
JDE 4.1.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
setInHolsterInputProcess
public abstract boolean setInHolsterInputProcess()
Deprecated.
Sets the invoking process to receive input events when the device is in
the holster.
Returns:
True if the invocation was successful; false if there is already
another in-holster process set.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
unlockSystem
public abstract void unlockSystem()
Unlocks the system.
Calling this method blocks until the system actually unlocks.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Copyright 1999-2008 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved. Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. Copyright 2002-2003 Nokia Corporation All Rights Reserved. Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.