< prev index next >

src/java.desktop/share/classes/java/awt/Desktop.java

Print this page

        

*** 125,135 **** peer = ((SunToolkit) defaultToolkit).createDesktopPeer(this); } } /** ! * Returns the <code>Desktop</code> instance of the current * browser context. On some platforms the Desktop API may not be * supported; use the {@link #isDesktopSupported} method to * determine if the current desktop is supported. * @return the Desktop instance of the current browser context * @throws HeadlessException if {@link --- 125,135 ---- peer = ((SunToolkit) defaultToolkit).createDesktopPeer(this); } } /** ! * Returns the {@code Desktop} instance of the current * browser context. On some platforms the Desktop API may not be * supported; use the {@link #isDesktopSupported} method to * determine if the current desktop is supported. * @return the Desktop instance of the current browser context * @throws HeadlessException if {@link
*** 160,171 **** /** * Tests whether this class is supported on the current platform. * If it's supported, use {@link #getDesktop()} to retrieve an * instance. * ! * @return <code>true</code> if this class is supported on the ! * current platform; <code>false</code> otherwise * @see #getDesktop() */ public static boolean isDesktopSupported(){ Toolkit defaultToolkit = Toolkit.getDefaultToolkit(); if (defaultToolkit instanceof SunToolkit) { --- 160,171 ---- /** * Tests whether this class is supported on the current platform. * If it's supported, use {@link #getDesktop()} to retrieve an * instance. * ! * @return {@code true} if this class is supported on the ! * current platform; {@code false} otherwise * @see #getDesktop() */ public static boolean isDesktopSupported(){ Toolkit defaultToolkit = Toolkit.getDefaultToolkit(); if (defaultToolkit instanceof SunToolkit) {
*** 184,195 **** * application registered to open it. In this case, {@link * #isSupported} may return {@code true}, but the corresponding * action method will throw an {@link IOException}. * * @param action the specified {@link Action} ! * @return <code>true</code> if the specified action is supported on ! * the current platform; <code>false</code> otherwise * @see Desktop.Action */ public boolean isSupported(Action action) { return peer.isSupported(action); } --- 184,195 ---- * application registered to open it. In this case, {@link * #isSupported} may return {@code true}, but the corresponding * action method will throw an {@link IOException}. * * @param action the specified {@link Action} ! * @return {@code true} if the specified action is supported on ! * the current platform; {@code false} otherwise * @see Desktop.Action */ public boolean isSupported(Action action) { return peer.isSupported(action); }
*** 228,239 **** } } /** ! * Calls to the security manager's <code>checkPermission</code> method with ! * an <code>AWTPermission("showWindowWithoutWarningBanner")</code> * permission. */ private void checkAWTPermission(){ SecurityManager sm = System.getSecurityManager(); if (sm != null) { --- 228,239 ---- } } /** ! * Calls to the security manager's {@code checkPermission} method with ! * an {@code AWTPermission("showWindowWithoutWarningBanner")} * permission. */ private void checkAWTPermission(){ SecurityManager sm = System.getSecurityManager(); if (sm != null) {
*** 257,267 **** * @throws IOException if the specified file has no associated * application or the associated application fails to be launched * @throws SecurityException if a security manager exists and its * {@link java.lang.SecurityManager#checkRead(java.lang.String)} * method denies read access to the file, or it denies the ! * <code>AWTPermission("showWindowWithoutWarningBanner")</code> * permission, or the calling thread is not allowed to create a * subprocess * @see java.awt.AWTPermission */ public void open(File file) throws IOException { --- 257,267 ---- * @throws IOException if the specified file has no associated * application or the associated application fails to be launched * @throws SecurityException if a security manager exists and its * {@link java.lang.SecurityManager#checkRead(java.lang.String)} * method denies read access to the file, or it denies the ! * {@code AWTPermission("showWindowWithoutWarningBanner")} * permission, or the calling thread is not allowed to create a * subprocess * @see java.awt.AWTPermission */ public void open(File file) throws IOException {
*** 288,298 **** * @throws SecurityException if a security manager exists and its * {@link java.lang.SecurityManager#checkRead(java.lang.String)} * method denies read access to the file, or {@link * java.lang.SecurityManager#checkWrite(java.lang.String)} method * denies write access to the file, or it denies the ! * <code>AWTPermission("showWindowWithoutWarningBanner")</code> * permission, or the calling thread is not allowed to create a * subprocess * @see java.awt.AWTPermission */ public void edit(File file) throws IOException { --- 288,298 ---- * @throws SecurityException if a security manager exists and its * {@link java.lang.SecurityManager#checkRead(java.lang.String)} * method denies read access to the file, or {@link * java.lang.SecurityManager#checkWrite(java.lang.String)} method * denies write access to the file, or it denies the ! * {@code AWTPermission("showWindowWithoutWarningBanner")} * permission, or the calling thread is not allowed to create a * subprocess * @see java.awt.AWTPermission */ public void edit(File file) throws IOException {
*** 359,369 **** * @throws IOException if the user default browser is not found, * or it fails to be launched, or the default handler application * failed to be launched * @throws SecurityException if a security manager exists and it * denies the ! * <code>AWTPermission("showWindowWithoutWarningBanner")</code> * permission, or the calling thread is not allowed to create a * subprocess; and not invoked from within an applet or Java Web Started * application * @throws IllegalArgumentException if the necessary permissions * are not available and the URI can not be converted to a {@code URL} --- 359,369 ---- * @throws IOException if the user default browser is not found, * or it fails to be launched, or the default handler application * failed to be launched * @throws SecurityException if a security manager exists and it * denies the ! * {@code AWTPermission("showWindowWithoutWarningBanner")} * permission, or the calling thread is not allowed to create a * subprocess; and not invoked from within an applet or Java Web Started * application * @throws IllegalArgumentException if the necessary permissions * are not available and the URI can not be converted to a {@code URL}
*** 413,423 **** * does not support the {@link Desktop.Action#MAIL} action * @throws IOException if the user default mail client is not * found, or it fails to be launched * @throws SecurityException if a security manager exists and it * denies the ! * <code>AWTPermission("showWindowWithoutWarningBanner")</code> * permission, or the calling thread is not allowed to create a * subprocess * @see java.awt.AWTPermission */ public void mail() throws IOException { --- 413,423 ---- * does not support the {@link Desktop.Action#MAIL} action * @throws IOException if the user default mail client is not * found, or it fails to be launched * @throws SecurityException if a security manager exists and it * denies the ! * {@code AWTPermission("showWindowWithoutWarningBanner")} * permission, or the calling thread is not allowed to create a * subprocess * @see java.awt.AWTPermission */ public void mail() throws IOException {
*** 436,464 **** /** * Launches the mail composing window of the user default mail * client, filling the message fields specified by a {@code * mailto:} URI. * ! * <p> A <code>mailto:</code> URI can specify message fields * including <i>"to"</i>, <i>"cc"</i>, <i>"subject"</i>, * <i>"body"</i>, etc. See <a * href="http://www.ietf.org/rfc/rfc2368.txt">The mailto URL * scheme (RFC 2368)</a> for the {@code mailto:} URI specification * details. * * @param mailtoURI the specified {@code mailto:} URI * @throws NullPointerException if the specified URI is {@code * null} * @throws IllegalArgumentException if the URI scheme is not ! * <code>"mailto"</code> * @throws UnsupportedOperationException if the current platform * does not support the {@link Desktop.Action#MAIL} action * @throws IOException if the user default mail client is not * found or fails to be launched * @throws SecurityException if a security manager exists and it * denies the ! * <code>AWTPermission("showWindowWithoutWarningBanner")</code> * permission, or the calling thread is not allowed to create a * subprocess * @see java.net.URI * @see java.awt.AWTPermission */ --- 436,464 ---- /** * Launches the mail composing window of the user default mail * client, filling the message fields specified by a {@code * mailto:} URI. * ! * <p> A {@code mailto:} URI can specify message fields * including <i>"to"</i>, <i>"cc"</i>, <i>"subject"</i>, * <i>"body"</i>, etc. See <a * href="http://www.ietf.org/rfc/rfc2368.txt">The mailto URL * scheme (RFC 2368)</a> for the {@code mailto:} URI specification * details. * * @param mailtoURI the specified {@code mailto:} URI * @throws NullPointerException if the specified URI is {@code * null} * @throws IllegalArgumentException if the URI scheme is not ! * {@code "mailto"} * @throws UnsupportedOperationException if the current platform * does not support the {@link Desktop.Action#MAIL} action * @throws IOException if the user default mail client is not * found or fails to be launched * @throws SecurityException if a security manager exists and it * denies the ! * {@code AWTPermission("showWindowWithoutWarningBanner")} * permission, or the calling thread is not allowed to create a * subprocess * @see java.net.URI * @see java.awt.AWTPermission */
< prev index next >