|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.awt.Desktop
public class Desktop
This class enables Java application to access system commands to perform
desktop oriented operations, like writing and sending emails, or surfing
webpages with the system browser or editing/printing files with a default
editor. Methods are provided to handle these common operations, plus an
open
command selects a default registered application for the
specified file type. For example, opening an odf file results in launching
OpenOffice. If an operation is not supported, or the application fails to
launch, an exception is generated.
Implementation note: As this class is used to manage Desktop
integration, we provide some extension to configure the behaviour of this
class depending on the type of dektop that is detected.
First of all, we support 5 system properties that can be used to define
the application to launch in any given case. These properties are:
gnu.java.awt.peer.Desktop.html.command
gnu.java.awt.peer.Desktop.mail.command
gnu.java.awt.peer.Desktop.edit.command
gnu.java.awt.peer.Desktop.print.command
gnu.java.awt.peer.Desktop.open.command
These can be specified from the command line and have priority on every
other setting.
The second method supported is defining a Java preference.
The main preference node is a user node relative to the
class gnu.java.awt.peer.ClasspathDesktopPeer
. This node
contains a child for each supported operation. The key for each type is
always command
:
gnu.java.awt.peer.Desktop.html.command
gnu.java.awt.peer.Desktop.mail.command
gnu.java.awt.peer.Desktop.edit.command
gnu.java.awt.peer.Desktop.print.command
gnu.java.awt.peer.Desktop.open.command
The access to these keys is done with the Preference API or, if outside
of the java scope, is done in a backend dependent way. For example,
with the GConf backend, you can access these properties
with (may not be accurate on your system):
gconftool-2 -g /apps/classpath/gnu/java/awt/peer/Desktop/html/command
Nested Class Summary | |
---|---|
static class |
Desktop.Action
Represents an action type supported by a platform. |
Method Summary | |
---|---|
void |
browse(URI uri)
Launches the Desktop default browser to open the given uri . |
void |
edit(File file)
Launch the edit command to edit this file. |
static Desktop |
getDesktop()
Returns an instance of the Desktop Class. |
static boolean |
isDesktopSupported()
Check if this implementation supports Desktop. |
boolean |
isSupported(Desktop.Action action)
Check if the given Action is supported by this implementation. |
void |
mail()
Launches the Desktop default mailer. |
void |
mail(URI mailtoURI)
Launches the Desktop default mailer, with the given mailtoURI as agrument. |
void |
open(File file)
Launches the Desktop default application to open the given File. |
void |
print(File file)
Launch the print program to print this file. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public static Desktop getDesktop() throws UnsupportedOperationException, HeadlessException
UnsupportedOperationException
HeadlessException
public static boolean isDesktopSupported()
public boolean isSupported(Desktop.Action action)
action
-
public void browse(URI uri) throws IOException
uri
.
If a security manager exists and denies
AWTPermission("showWindowWithoutWarningBanner"),a SecurityException will
be generated.
uri
-
IOException
public void edit(File file) throws IOException
file
-
IOException
public void mail() throws IOException
IOException
public void mail(URI mailtoURI) throws IOException
mailtoURI
must conform to the
The mailto URL scheme (RFC 2368)
If a security manager exists and denies
AWTPermission("showWindowWithoutWarningBanner"), a SecurityException will
be generated.
mailtoURI
-
IOException
public void open(File file) throws IOException
file
is a directory, a file manager is launched.
file
-
IOException
public void print(File file) throws IOException
file
-
IOException
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |