java.awt

Рабочий стол класса

java.lang. Объект

java.awt. Рабочий стол

public class Desktop
extends Object

Desktop class позволяет приложению Java запускать связанные приложения, зарегистрированные на собственном рабочем столе, чтобы обработать a URI или файл.

Поддерживаемые операции включают:

• запуск браузера пользовательского значения по умолчанию, чтобы показать указанный URI;
• запуск почтового клиента пользовательского значения по умолчанию с дополнительным mailto URI;
• запуская зарегистрированное приложение, чтобы открыться, отредактируйте или напечатайте указанный файл.

Этот class обеспечивает методы, соответствующие этим операциям. Методы ищут связанное приложение, зарегистрированное на текущей платформе, и запускают это, чтобы обработать URI или файл. Если нет никакого связанного приложения, или связанное приложение не в состоянии быть запущенным, исключение выдается.

Приложение регистрируется к URI или типу файла; например, "sxi" расширение файла обычно регистрируется к StarOffice. Механизм регистрации, доступа, и запуска связанного приложения зависим от платформы.

Каждая работа является типом действия, представленным Desktop.Action class.

Отметьте: когда некоторое действие вызывается, и связанное приложение выполняется, это будет выполняться на той же самой системе как тот, на котором было запущено приложение Java.

С тех пор:

1.6

Вложенная Сводка Класса

Вложенные Классы

Модификатор и Тип	Класс и Описание
static class	Рабочий стол. Действие Представляет тип действия.

Сводка метода

Модификатор и Тип	Метод и Описание
void	browse(URI uri) Запускает браузер значения по умолчанию, чтобы вывести на экран a URI.
void	edit(File file) Запускает связанное приложение редактора и открывает файл для того, чтобы отредактировать.
static Desktop	getDesktop() Возвраты Desktop экземпляр текущего контекста браузера.
static boolean	isDesktopSupported() Тесты, поддерживается ли этот class на текущей платформе.
boolean	isSupported(Desktop.Action action) Тесты, поддерживается ли действие на текущей платформе.
void	mail() Запускает почтовое окно создания пользовательского почтового клиента значения по умолчанию.
void	mail(URI mailtoURI) Запускает почтовое окно создания пользовательского почтового клиента значения по умолчанию, заполняя поля сообщения, определенные a mailto: URI.
void	open(File file) Запускает связанное приложение, чтобы открыть файл.
void	print(File file) Печатает файл с собственным настольным средством печати, используя команду печати связанного приложения.

Методы, наследованные от class java.lang. Объект

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

Деталь метода

getDesktop

public static Desktop getDesktop()

Возвраты Desktop экземпляр текущего контекста браузера. На некоторых платформах не может поддерживаться Настольный API; используйте isDesktopSupported() метод, чтобы определить, поддерживается ли текущий рабочий стол.

Возвраты:

Настольный экземпляр текущего контекста браузера

Броски:

HeadlessException - если GraphicsEnvironment.isHeadless() возвраты true

UnsupportedOperationException - если этот class не поддерживается на текущей платформе

См. Также:

isDesktopSupported(), GraphicsEnvironment.isHeadless()

isDesktopSupported

public static boolean isDesktopSupported()

Тесты, поддерживается ли этот class на текущей платформе. Если это поддерживается, использовать getDesktop() получать экземпляр.

Возвраты:

true если этот class поддерживается на текущей платформе; 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

открытый

public void open(File file)
          throws IOException

Запускает связанное приложение, чтобы открыть файл.

Если указанный файл является каталогом, файловый менеджер текущей платформы запускается, чтобы открыть его.

Параметры:

file - файл, который будет открыт со связанным приложением

Броски:

NullPointerException - если file null

IllegalArgumentException - если указанный файл не существует

UnsupportedOperationException - если текущая платформа не поддерживает Desktop.Action.OPEN действие

IOException - если у указанного файла нет никакого связанного приложения, или связанное приложение не в состоянии быть запущенным

SecurityException - если менеджер безопасности существует и SecurityManager.checkRead(java.lang.String) метод отрицает доступ для чтения к файлу, или это отрицает AWTPermission("showWindowWithoutWarningBanner") разрешению, или вызывающему потоку не позволяют создать подпроцесс

См. Также:

AWTPermission

редактирование

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

печать

public void print(File file)
           throws IOException

Печатает файл с собственным настольным средством печати, используя команду печати связанного приложения.

Параметры:

file - файл, который будет напечатан

Броски:

NullPointerException - если указанный файл null

IllegalArgumentException - если указанный файл не существует

UnsupportedOperationException - если текущая платформа не поддерживает Desktop.Action.PRINT действие

IOException - если у указанного файла нет никакого связанного приложения, которое может использоваться, чтобы напечатать его

SecurityException - если менеджер безопасности существует и SecurityManager.checkRead(java.lang.String) метод отрицает доступ для чтения к файлу, или SecurityManager.checkPrintJobAccess() метод отрицает, что разрешение печатает файл, или вызывающему потоку не позволяют создать подпроцесс

обзор

public void browse(URI uri)
            throws IOException

Запускает браузер значения по умолчанию, чтобы вывести на экран a URI. Если браузер значения по умолчанию не в состоянии обработать указанное URI, приложение зарегистрировалось для того, чтобы обработать URIs из указанного типа вызывается. Приложение определяется из протокола и пути URI, как определено URI class.

Если у вызывающего потока нет необходимых полномочий, и это вызывается изнутри апплета, AppletContext.showDocument() используется. Точно так же, если у вызова нет необходимых полномочий, и это вызывается изнутри Сети Java Запущенное приложение, BasicService.showDocument() используется.

Параметры:

uri - URI, который будет выведен на экран в пользовательском браузере значения по умолчанию

Броски:

NullPointerException - если uri null

UnsupportedOperationException - если текущая платформа не поддерживает Desktop.Action.BROWSE действие

IOException - если пользовательский браузер значения по умолчанию не находится, или он не в состоянии быть запущенным, или приложение обработчика значения по умолчанию, отказавшее, чтобы быть запущенным

SecurityException - если менеджер безопасности существует, и он отрицает AWTPermission("showWindowWithoutWarningBanner") разрешению, или вызывающему потоку не позволяют создать подпроцесс; и не вызванный изнутри апплета или Сети Java Запущенное приложение

IllegalArgumentException - если необходимые полномочия не доступны, и URI не может быть преобразован в a URL

См. Также:

URI, AWTPermission, AppletContext

почта

public void mail()
          throws IOException

Запускает почтовое окно создания пользовательского почтового клиента значения по умолчанию.

Броски:

UnsupportedOperationException - если текущая платформа не поддерживает Desktop.Action.MAIL действие

IOException - если пользовательский почтовый клиент значения по умолчанию не находится, или это не в состоянии быть запущенным

SecurityException - если менеджер безопасности существует, и он отрицает AWTPermission("showWindowWithoutWarningBanner") разрешению, или вызывающему потоку не позволяют создать подпроцесс

См. Также:

AWTPermission

почта

public void mail(URI mailtoURI)
          throws IOException

Запускает почтовое окно создания пользовательского почтового клиента значения по умолчанию, заполняя поля сообщения, определенные a mailto: URI.

A mailto: URI может определить поля сообщения включая "к", "cc", "предмет", "тело", и т.д. Видеть mailto схему URL (RFC 2368) для mailto: Детали спецификации URI.

Параметры:

mailtoURI - указанное mailto: URI

Броски:

NullPointerException - если указанный URI null

IllegalArgumentException - если схема URI не "mailto"

UnsupportedOperationException - если текущая платформа не поддерживает Desktop.Action.MAIL действие

IOException - если пользовательский почтовый клиент значения по умолчанию не находится или не в состоянии быть запущенным

SecurityException - если менеджер безопасности существует, и он отрицает AWTPermission("showWindowWithoutWarningBanner") разрешению, или вызывающему потоку не позволяют создать подпроцесс

См. Также:

URI, AWTPermission