net.rim.device.api.content
Class InvocationUtilities

java.lang.Object
  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