java.awt

Class Desktop

java.lang.Object

java.awt.Desktop

public class Desktop
extends Object

的 Desktop类允许java应用程序启动相关的应用程序注册的本地桌面操作 URI或文件。

支持的操作包括：

• 启动用户的默认浏览器显示一个指定的URI；
• 一个可选的mailto URI启动用户默认的邮件客户端；
• 启动已注册的应用程序打开、编辑或打印指定的文件。

此类提供了对应于这些操作的方法。的方法寻找相关的应用程序在当前平台上注册，并启动它来处理一个URI或文件。如果没有相关的应用程序或相关的应用程序无法启动，则抛出一个异常。

一个应用程序注册到一个URI或文件类型；例如，在"sxi"文件扩展名通常是注册StarOffice。注册、访问和启动关联的应用程序的机制是依赖于平台的。

每一个操作动作类型的Desktop.Action班代表。

注意：当一些动作被调用和关联的应用程序执行时，它将执行相同的系统作为java应用程序启动。

从以下版本开始：

一点六

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Desktop.Action 表示动作类型。

方法摘要

Modifier and Type	Method and Description
void	browse(URI uri) 启动默认的浏览器显示一个 URI。
void	edit(File file) 启动相关的编辑器应用程序，并打开一个编辑文件。
static Desktop	getDesktop() 返回当前浏览器上下文的 Desktop实例。
static boolean	isDesktopSupported() 测试这个类是否在当前平台上支持。
boolean	isSupported(Desktop.Action action) 测试一个动作是否在当前平台上支持。
void	mail() 启动用户默认邮件客户端的邮件组合窗口。
void	mail(URI mailtoURI) 启动邮件撰写窗口的用户默认的邮件客户端，填充的 mailto: URI指定的消息字段。
void	open(File file) 启动相关的应用程序打开文件。
void	print(File file) 使用相关应用程序的打印命令，打印一个与本机桌面打印设备的文件。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细信息

getDesktop

public static Desktop getDesktop()

返回当前浏览器上下文的 Desktop实例。在一些平台的桌面API可能不支持；使用 isDesktopSupported()方法确定当前的桌面支持。

结果

当前浏览器上下文的桌面实例

异常

HeadlessException -如果 GraphicsEnvironment.isHeadless()返回 true

如果这类 UnsupportedOperationException当前平台上不支持

另请参见：

isDesktopSupported()， GraphicsEnvironment.isHeadless()

isDesktopSupported

public static boolean isDesktopSupported()

测试这个类是否在当前平台上支持。如果它的支持，使用 getDesktop()检索实例。

结果

true如果这个类是支持目前的平台； false否则

另请参见：

getDesktop()

isSupported

public boolean isSupported(Desktop.Action action)

测试一个动作是否在当前平台上支持。

即使平台支持一个行动，一个文件或URI可能没有注册申请的行为。例如，大多数的平台支持Desktop.Action.OPEN行动。但对于一个特定的文件，可能没有一个注册的应用程序打开它。在这种情况下，isSupported(java.awt.Desktop.Action)可能返回true，但相应的动作方法将抛出一个IOException。

参数

action -指定 Desktop.Action

结果

true如果指定的行动支持当前的平台； false否则

另请参见：

Desktop.Action

open

public void open(File file)
          throws IOException

启动相关的应用程序打开文件。

如果指定的文件是一个目录，则启动当前平台的文件管理器打开它。

参数

file -文件打开与相关应用

异常

如果是 null file NullPointerException

IllegalArgumentException -如果指定的文件不存在

UnsupportedOperationException -如果当前平台不支持 Desktop.Action.OPEN行动

IOException -如果指定文件没有关联的应用程序或相关的应用程序无法启动

SecurityException -如果存在一个安全管理及其 SecurityManager.checkRead(java.lang.String)方法拒绝读取该文件，或否认 AWTPermission("showWindowWithoutWarningBanner")许可，或调用线程不允许创建子进程

另请参见：

AWTPermission

edit

public void edit(File file)
          throws IOException

启动相关的编辑器应用程序，并打开一个编辑文件。

参数

file -文件可打开编辑

异常

NullPointerException -如果指定的文件 null

IllegalArgumentException -如果指定的文件不存在

UnsupportedOperationException -如果当前平台不支持 Desktop.Action.EDIT行动

IOException -如果指定文件没有关联的编辑器，或相关的应用程序无法启动

SecurityException -如果存在一个安全管理及其 SecurityManager.checkRead(java.lang.String)方法拒绝读取该文件，或 SecurityManager.checkWrite(java.lang.String)方法拒绝写访问文件，或否认 AWTPermission("showWindowWithoutWarningBanner")许可，或调用线程不允许创建子进程

另请参见：

AWTPermission

print

public void print(File file)
           throws IOException

使用相关应用程序的打印命令，打印一个与本机桌面打印设备的文件。

参数

file -待打印文件

异常

NullPointerException -如果指定的文件 null

IllegalArgumentException -如果指定的文件不存在

UnsupportedOperationException -如果当前平台不支持 Desktop.Action.PRINT行动

IOException -如果指定文件没有关联的应用程序，可以用来打印

SecurityException -如果存在一个安全管理及其 SecurityManager.checkRead(java.lang.String)方法拒绝读取该文件，或其 SecurityManager.checkPrintJobAccess()方法拒绝允许打印文件，或者调用线程不允许创建子进程

browse

public void browse(URI uri)
            throws IOException

启动默认的浏览器显示一个 URI。如果默认的浏览器是不能够处理指定的 URI，申请注册处理指定类型的 URIs调用。从应用程序的 URI协议和路径确定，由 URI类定义。

如果调用线程没有必要的权限，这是从一个小程序调用，使用AppletContext.showDocument()。同样，如果调用不必要的权限，这是从一个java web应用程序调用的使用开始，BasicService.showDocument()。

参数

uri的URI是在用户的默认浏览器显示

异常

如果是 null uri NullPointerException

UnsupportedOperationException -如果当前平台不支持 Desktop.Action.BROWSE行动

IOException -如果用户的默认浏览器是没有发现，或者不能被启动，或默认处理程序无法启动应用程序

SecurityException -如果存在一个安全管理和否认 AWTPermission("showWindowWithoutWarningBanner")许可，或调用线程不允许创建子进程；而不是内部调用applet或应用java web开始

IllegalArgumentException -如果必要的权限不可用和URI不能转换为 URL

另请参见：

URI， AWTPermission， AppletContext

mail

public void mail()
          throws IOException

启动用户默认邮件客户端的邮件组合窗口。

异常

UnsupportedOperationException -如果当前平台不支持 Desktop.Action.MAIL行动

IOException -如果用户默认邮件客户端没有找到，或者不能被启动

SecurityException -如果存在一个安全管理和否认 AWTPermission("showWindowWithoutWarningBanner")许可，或调用线程不允许创建子进程

另请参见：

AWTPermission

mail

public void mail(URI mailtoURI)
          throws IOException

启动邮件撰写窗口的用户默认的邮件客户端，填充的 mailto: URI指定的消息字段。

一个mailto: URI可以指定消息字段包括空”，空“CC”、“空”，空主体”身体”，等看到The mailto URL scheme (RFC 2368)为mailto: URI规范细节。

参数

mailtoURI -指定 mailto: URI

异常

NullPointerException -如果指定的URI是 null

IllegalArgumentException -如果URI方案是不 "mailto"

UnsupportedOperationException -如果当前平台不支持 Desktop.Action.MAIL行动

IOException -如果用户默认邮件客户端找不到或无法启动

SecurityException -如果存在一个安全管理和否认 AWTPermission("showWindowWithoutWarningBanner")许可，或调用线程不允许创建子进程

另请参见：

URI， AWTPermission