+ * @exception NotFoundException if the Eikon window group is not found + * @throws RuntimeException if any other error condition arises in native code + */ + public static void displayTaskList() throws NotFoundException + { + err = DisplayTaskList(); + if (err != 0) + { + handleWgError(err); + } + } + + /** + * Allows the Java app to find out if it is currently in the foreground. To do + * this it relies on the fact that the Java app's window group (if it has one) + * will always be given by the com.symbian.appName system property + *
+ * @exception NotFoundException if the window group associated with the Java app + * name is not found + * @throws RuntimeException if any other error condition arises in native code + */ + public static boolean isForeground() throws NotFoundException + { + int result = IsForeground(System.getProperty("com.symbian.appName")); + if (result < 0) + { + handleWgError(result); // throws an Exception + } + if (result == 0) + { + return false; + } + else + { + return true; + } + } + + + /** + * Brings to the foreground the window group for the app with a given caption. + * @param caption the task to bring to the foreground + * @exception NotFoundException if the window group with the caption specified + * is not found + * @throws RuntimeException if any other error condition arises in native code + */ + + public static void taskToForeground(String caption) throws NotFoundException + { + err = TaskToForeground(caption); + if(err != 0) + { + handleWgError(err); + } + } + + /** + * Displays the string "text" as an info message in the top right hand corner + * of the screen for a few seconds. The rest of the screen remains responsive + * to user input. + * @param text the text which is displayed in the InfoPrint box + * @throws RuntimeException if any error condition arises in native code + */ + public static void infoPrint(String text) + { + err = InfoPrint(text); + if(err != KErrNone) + { + throw(new RuntimeException("InfoPrint failed. EPOC error code was: " + err)); + } + } + + /** + * Displays a modal dialog asking the user for a confirmation. + * @param line1 the title displayed in the dialog box + * @param line2 the question to be answered + * @param but1 the text for the negative response button + * @param but2 the text for the positive response button + * @return 0 for a "no" and 1 for a "yes" + * @throws RuntimeException if any error condition arises in native code + */ + public static int notify(String line1, String line2, String but1, String but2) + { + int ret = Notify(line1, line2, but1, but2); + if (ret < 0) + { + throw(new RuntimeException("Notify failed. EPOC error code was: " + ret)); + } + else + { + return ret; + } + + } + + + /** + *
Handles EPOC errors arising while attempting to locate non-Java window groups.
+ * Called by {@link #displayTaskList() displayTaskList},
+ * {@link #isForeground() isForeground} and {@link #taskToForeground(java.lang.String) taskToForeground}
+ * in response to EPOC error codes other than KErrNone = 0.
A {@link com.symbian.devnet.util.NotFoundException NotFoundException}
+ * is thrown in response to EPOC error KErrNotFound = -1.
+ * A RuntimeException, specifying the EPOC error code in its detail message
+ * string, is thrown in all other cases.