java.awt Clase Desktop
Esquema de Herencia
Public class Desktop
La clase Desktop permite que una aplicación Java pueda lanzar otras aplicaciones el escritorio nativas para manejar un URI (dirección)o un archivo. Es decir que desde la aplicación java podemos hacer que se abran otras aplicaciones del sistema, ya sea para abrir un archivo, imprimir, abrir un sitio web, abrir el cliente de correo, etc
Entre las operaciones soportadas incluyen:
- lanzar el navegador predeterminado de usuario para mostrar un URI (en java los objetos URI son coma la dirección de un archivo);
- el lanzamiento del cliente de correo predeterminado del usuario, la opción de enviar un parámetro URI con la dirección de correo, asunto, etc;
- el lanzamiento de una aplicación registrada para abrir, editar o imprimir un archivo especificado.
Esta clase proporciona los métodos correspondientes a estas operaciones. Los métodos de buscar la aplicación asociada registrados en la plataforma actual, y lanzar un URI para manejar o el archivo. Si no hay ninguna aplicación asociada o la aplicación asociada no se pone en marcha, se produce una excepción.
La solicitud es registrada en una URI o tipo de archivo, por ejemplo, el "sxi" extensión de archivo esta normalmente registrado para StarOffice. El mecanismo de registro, el acceso, y el lanzamiento de la aplicación asociada depende de la plataforma (Sistema Operativo).
Cada operación es un tipo de acción representada por la clase Desktop.Action.
Nota: cuando alguna acción se invoca y la aplicación asociada se ejecuta, se ejecutará en el mismo sistema que el de la aplicación que se puso en marcha el Java.
Desde:
1,6
Resumen de clase | |
static class | Desktop.Action Representa un tipo de acción. |
Resumen de los métodos | |
void | browse ( URI uri) Inicia el navegador predeterminado para mostrar un URI . |
void | edit ( File file) Inicia la aplicación de editor asociado y abre un archivo para su edición. |
static Desktop | getDesktop () Devuelve el Desktop ejemplo del contexto actual del navegador. |
static boolean | isDesktopSupported () Comprueba si esta clase es compatible con la plataforma actual. |
boolean | isSupported ( Desktop.Action action) Comprueba si una acción es compatible con la plataforma actual. |
void | mail () Lanza el correo que compone la ventana del cliente de correo predeterminado de usuario. |
void | mail ( URI mailtoURI) Lanza el correo que componen la ventana del cliente de correo predeterminado del usuario, rellenando los campos del mensaje especificado por un mailto: URI. |
void | open ( File file) Inicia la aplicación asociada para abrir el archivo. |
void | print ( File file) Imprime un archivo con la facilidad de impresión de escritorio nativas, con asociados de aplicaciones de impresión comando. |
Detalle de los Métodos |
getDesktop
public static synchronized Desktop getDesktop(){
Devuelve el Desktop, que es tratado como objeto en Java, este contiene todos los demás métodos a excepción de isDesktopSupported. En algunas plataformas de escritorio de la API no podrá contar con el uso de isDesktopSupported() método para determinar si el escritorio actual es compatible.
Returns: Devoluciones:
la instancia de escritorio del contexto actual del navegador
Throws: Lanza la siguientes exepciones:
HeadlessException - if GraphicsEnvironment.isHeadless() return UnsupportedOperationExceptionUnsupportedOperationException - si esta clase no es compatible con la plataforma actual
Ver también:
isDesktopSupported()GraphicsEnvironment.isHeadless()
isDesktopSupported
public static boolean isDesktopSupported ()
Comprueba si esta clase es compatible con la plataforma actual. Si es compatible, utilice getDesktop() para recuperar una instancia.
Devoluciones:
true si esta clase es compatible con la plataforma actual; false de lo contrario.
Ejemplo:
if (Desktop.isDesktopSupported()) { System.out.println("El SO soporta la clase Desktop"); }else{ System.out.println(“El SO no soporta la clase desktop”); }See Also: Ver también:
getDesktop()
isSupported
public boolean isSupported (Desktop.Action action)
Comprueba si una acción es compatible con la plataforma actual.
Aun cuando la plataforma apoya una acción, un archivo o URI no puede tener una aplicación registrada para la acción. Por ejemplo, la mayoría de las plataformas de soportan la acción Desktop.Action.OPEN . Pero para un archivo específico, no puede presentar una solicitud registrada para abrirlo. En este caso, isSupported(java.awt.Desktop.Action) puede devolver true, pero el método de la acción correspondiente se lanzará una IOException .
Parámetros:
el objetivo específico Desktop.Action
Devoluciones:
true si la acción especificada es compatible con la plataforma actual; false de lo contrario
open
public void open ( File file) public void open(File file)
lanza IOException
Inicia la aplicación asociada para abrir el archivo.
Si el archivo especificado es un directorio, el gestor de archivos de la plataforma actual se pone en marcha para abrirlo.
Parameters: Parámetros:
file - el archivo que se abrirá con la aplicación asociada
Throws: Lanza:
NullPointerException - si file es null
IllegalArgumentException - if the specified file dosen't exist IllegalArgumentException - si el archivo especificado no existe.
UnsupportedOperationException - si la plataforma actual no es compatible con la acción Desktop.Action.OPEN
IOException - si el archivo especificado no tiene asociada la aplicación o la aplicación asociada deja de ser lanzado
SecurityException - si existe un controlador de seguridad y su método SecurityManager.checkRead(java.lang.String) niega el acceso de lectura al expediente, o se niega el permiso AWTPermission("showWindowWithoutWarningBanner"), o el hilo que llama no se le permite crear un subproceso
edit
public void edit ( File file)
lanza IOException
Inicia la aplicación de editor asociado y abre un archivo para su edición.
Parámetros:
file - el archivo que se abrirá para su edición
Throws: Lanza:
NullPointerException - si el archivo especificado es null
IllegalArgumentException - si el archivo especificado no existe
UnsupportedOperationException - si la plataforma actual no es compatible con la accion Desktop.Action.EDIT
IOException - si el archivo especificado no tiene editor asociado, o la aplicación asociada deja de ser lanzado
SecurityException - si existe un administrador de seguridad y su SecurityManager.checkRead(java.lang.String) niega método de acceso de lectura al archivo o SecurityManager.checkWrite(java.lang.String) niega método de acceso de escritura al archivo, o niega la AWTPermission("showWindowWithoutWarningBanner") permiso, o el hilo de llamada no tiene permiso para crear un subproceso
print
public void print ( File file)
lanza IOException
Imprime un archivo con la facilidad de impresión de escritorio nativas, con asociados de aplicaciones de impresión comando.
Parámetros:
file - el archivo que desea imprimir
Throws: Lanza:
NullPointerException - si el archivo especificado es null
IllegalArgumentException - si el archivo especificado no existe
UnsupportedOperationException - si la plataforma actual no es compatible con la Desktop.Action.PRINT acción
IOException - si el archivo especificado no tiene ninguna aplicación asociada que se puede utilizar para imprimir
SecurityException - si existe un administrador de seguridad y su método SecurityManager.checkRead(java.lang.String) niega el acceso de lectura al expediente, o su SecurityManager.checkPrintJobAccess() método niega el permiso para imprimir el archivo, o el hilo que llama no está permitido para crear un subproceso
browse
public void browse ( URI uri)
lanza IOException
Inicia el navegador predeterminado para mostrar un URI . Si el navegador por defecto no es capaz de manejar las especificadas URI , la solicitud de registro para el manejo de URIs del tipo especificado que se invoque. La aplicación se determinará a partir del protocolo y la ruta de la URI , tal como se define por la URI de clase.
Si el hilo de la llamada no tiene los permisos necesarios, y esto se invoca desde dentro de un applet, se utiliza AppletContext.showDocument(). Del mismo modo, si la llamada no tiene los permisos necesarios, y esto se invoca desde dentro de una Web de inicio de aplicaciones Java, se utiliza BasicService.showDocument().
Parámetros:
uri - la URI (URL) que se mostrará en el navegador por defecto del usuario
Throws: Lanza:
NullPointerException - si uri es null
UnsupportedOperationException - si la plataforma actual no es compatible con la acción Desktop.Action.BROWSE
IOException - si el navegador predeterminado del usuario no se encuentra, o no puede ponerse en marcha, o el controlador de aplicación por defecto no se lanzará
SecurityException - si existe un administrador de seguridad y niega el permiso AWTPermission("showWindowWithoutWarningBanner"), o el hilo de llamada no tiene permiso para crear un subproceso, y no se invoca desde dentro de un applet o aplicación Web en Java Started
IllegalArgumentException - si los permisos necesarios no están disponibles y el URI no se puede convertir en una URL
mail
public void mail () public
throws IOException lanza IOException
Lanza el correo que compone la ventana del cliente de correo predeterminado del usuario.
Throws: Lanza:
UnsupportedOperationException - si la plataforma actual no es compatible con la acción Desktop.Action.MAIL
si el cliente de correo predeterminado de usuario no se encuentra, o no puede ponerse en marcha
SecurityException - si existe un administrador de seguridad y niega el permiso AWTPermission("showWindowWithoutWarningBanner"), o el hilo de llamada no tiene permiso para crear un subproceso
mail
public void mail ( URI mailtoURI)
lanza IOException
Lanza el correo que componen la ventana del cliente de correo predeterminado del usuario, rellenando los campos del mensaje especificado por un mailto: URI.
Un(a) URI puede especificar los campos de mensaje como "a", "cc", "asunto", "cuerpo",("to" , "cc" , "subject" , "body"), etc. Ver El esquema de URL mailto (RFC 2368) para el “mailto:” para las especificaciones del URI.
Parameters: Parámetros:
URI mailtoURI – URI especificado
Throws: Lanza:
NullPointerException - si el URI especificado es null
IllegalArgumentException - si el esquema no es URI "mailto"
si la plataforma actual no es compatible con la acción Desktop.Action.MAIL
IOException - si el cliente de correo predeterminado de usuario no se encuentra o no en marcha
SecurityException - si existe un administrador de seguridad y niega el permiso AWTPermission("showWindowWithoutWarningBanner"), o el hilo de llamada no tiene permiso para crear un subproceso.
No hay comentarios:
Publicar un comentario