net.rim.device.api.content
Class InvocationUtilities

java.lang.Object
  extended by net.rim.device.api.content.InvocationUtilities

public class InvocationUtilities
extends Object

This utilities class enhances functionality of Content Handler API.

One of the enhancements is foreground mode management. By default, the Invocation execution will bring the called application into foreground. To avoid that use the following:

 Invocation inv = new Invocation();
 InvocationUtilities.setRequestForeground( inv, false );
 

Since:
BlackBerry API 6.0.0

Method Summary
static void setRequestForeground(Invocation invocation, boolean requestForeground)
          Sets the foreground mode of the Invocation.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 



Method Detail

setRequestForeground

public static void setRequestForeground(Invocation invocation,
                                        boolean requestForeground)
Sets the foreground mode of the Invocation. By default the invocation brings the invoked application or MIDlet to foreground automatically. To suppress this default behavior, call this method with requestForeground = false parameter.

Note that this method affects both the calling and caller application modes. If false is specified then neither calling nor caller applications will get foreground automatically. The applications may request foreground at their discretion isolated from CHAPI.

Parameters:
invocation - invocation to be modified
requestForeground - specifies whether invocation should produce automatic switch to foreground, if false is given then no auto actions are performed
Since:
BlackBerry API 6.0.0





Copyright 1999-2010 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. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.