Spec-Zone .ru
спецификации, руководства, описания, API
|
public class Desktop extends Object
Desktop
класс позволяет приложению Java запускать связанные приложения, зарегистрированные на собственном рабочем столе, чтобы обработать a URI
или файл. Поддерживаемые операции включают:
mailto
URI;Этот класс обеспечивает методы, соответствующие этим операциям. Методы ищут связанное приложение, зарегистрированное на текущей платформе, и запускают это, чтобы обработать URI или файл. Если нет никакого связанного приложения, или связанное приложение не в состоянии быть запущенным, исключение выдается.
Приложение регистрируется к URI или типу файла; например, "sxi"
расширение файла обычно регистрируется к StarOffice. Механизм регистрации, доступа, и запуска связанного приложения зависим от платформы.
Каждая работа является типом действия, представленным Desktop.Action
класс.
Отметьте: когда некоторое действие вызывается, и связанное приложение выполняется, это будет выполняться на той же самой системе как тот, на котором было запущено приложение Java.
Модификатор и Тип | Класс и Описание |
---|---|
static class |
Рабочий стол. Действие
Представляет тип действия.
|
Модификатор и Тип | Метод и Описание |
---|---|
void |
browse(URI uri)
Запускает браузер по умолчанию, чтобы вывести на экран a
URI . |
void |
edit(File file)
Запускает связанное приложение редактора и открывает файл для того, чтобы отредактировать.
|
static Desktop |
getDesktop()
Возвраты
Desktop экземпляр текущего контекста браузера. |
static boolean |
isDesktopSupported()
Тесты, поддерживается ли этот класс на текущей платформе.
|
boolean |
isSupported(Desktop.Action action)
Тесты, поддерживается ли действие на текущей платформе.
|
void |
mail()
Запускает почтовое окно создания пользовательского значения по умолчанию почтовый клиент.
|
void |
mail(URI mailtoURI)
Запускает почтовое окно создания пользовательского значения по умолчанию почтовый клиент, заполняя поля сообщения, определенные a
mailto: URI. |
void |
open(File file)
Запускает связанное приложение, чтобы открыть файл.
|
void |
print(File file)
Печатает файл с собственным настольным средством печати, используя команду печати связанного приложения.
|
public static Desktop getDesktop()
Desktop
экземпляр текущего контекста браузера. На некоторых платформах не может поддерживаться Настольный API; используйте isDesktopSupported()
метод, чтобы определить, поддерживается ли текущий рабочий стол.HeadlessException
- если GraphicsEnvironment.isHeadless()
возвраты true
UnsupportedOperationException
- если этот класс не поддерживается на текущей платформеisDesktopSupported()
, GraphicsEnvironment.isHeadless()
public static boolean isDesktopSupported()
getDesktop()
получать экземпляр.true
если этот класс поддерживается на текущей платформе; false
иначеgetDesktop()
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
URI
. Если браузер по умолчанию не в состоянии обработать указанное URI
, приложение зарегистрировалось для того, чтобы обработать URIs
из указанного типа вызывается. Приложение определяется из протокола и пути URI
, как определено URI
класс. Если у вызывающего потока нет необходимых полномочий, и это вызывается изнутри апплета, 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
mailto:
URI. A mailto:
URI может определить поля сообщения включая "к", "cc", "предмет", "тело", и т.д. Видеть mailto:
Детали спецификации URI.
mailtoURI
- указанное mailto:
URINullPointerException
- если указанный URI null
IllegalArgumentException
- если схема URI не "mailto"
UnsupportedOperationException
- если текущая платформа не поддерживает Desktop.Action.MAIL
действиеIOException
- если пользовательское значение по умолчанию почтовый клиент не находится или не в состоянии быть запущеннымSecurityException
- если менеджер безопасности существует, и он отрицает AWTPermission("showWindowWithoutWarningBanner")
разрешению, или вызывающему потоку не позволяют создать подпроцессURI
, AWTPermission
Для дальнейшей ссылки API и документации разработчика, см.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.