java.awt.peer
Interface DesktopPeer

public interface DesktopPeer

Disabled: no SafeJ information.

The DesktopPeer interface provides methods for the operation of open, edit, print, browse and mail with the given URL or file, by launching the associated application.

Each platform has an implementation class for this interface.

Method Summary

void	browse(URI url) Launches the user default browser to display the given URI.
void	edit(File file) Launches the associated editor and opens the given file for editing.
boolean	isSupported(Desktop.Action action) Returns whether the given action is supported on the current platform.
void	mail(URI mailtoURL) Launches the mail composing window of the user default mail client, filling the message fields including to, cc, etc, with the values specified by the given mailto URL.
void	open(File file) Launches the associated application to open the given file.
void	print(File file) Prints the given file with the native desktop printing facility, using the associated application's print command.

Method Detail

isSupported

boolean isSupported(Desktop.Action action)

Class is disabled.

Returns whether the given action is supported on the current platform.

Parameters:

action - the action type to be tested if it's supported on the current platform.

Returns:

true if the given action is supported on the current platform; false otherwise.

open

void open(File file)
          throws IOException

Class is disabled.

Launches the associated application to open the given file. The associated application is registered to be the default file viewer for the file type of the given file.

Parameters:

file - the given file.

Throws:

IOException - If the given file has no associated application, or the associated application fails to be launched.

edit

void edit(File file)
          throws IOException

Class is disabled.

Launches the associated editor and opens the given file for editing. The associated editor is registered to be the default editor for the file type of the given file.

Parameters:

file - the given file.

Throws:

IOException - If the given file has no associated editor, or the associated application fails to be launched.

print

void print(File file)
           throws IOException

Class is disabled.

Prints the given file with the native desktop printing facility, using the associated application's print command.

Parameters:

file - the given file.

Throws:

IOException - If the given file has no associated application that can be used to print it.

mail

void mail(URI mailtoURL)
          throws IOException

Class is disabled.

Launches the mail composing window of the user default mail client, filling the message fields including to, cc, etc, with the values specified by the given mailto URL.

Parameters:

uri - represents a mailto URL with specified values of the message. The syntax of mailto URL is defined by RFC2368: The mailto URL scheme

Throws:

IOException - If the user default mail client is not found, or it fails to be launched.

browse

void browse(URI url)
            throws IOException

Class is disabled.

Launches the user default browser to display the given URI.

Parameters:

uri - the given URI.

Throws:

IOException - If the user default browser is not found, or it fails to be launched.