< prev index next >

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

Print this page

        

@@ -1,7 +1,7 @@
 /*
- * Copyright (c) 2016, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2016, 2018, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
  * under the terms of the GNU General Public License version 2 only, as
  * published by the Free Software Foundation.  Oracle designates this

@@ -23,29 +23,39 @@
  * questions.
  */
 
 package java.awt.desktop;
 
+import java.awt.Desktop;
+import java.awt.GraphicsEnvironment;
+import java.awt.HeadlessException;
 import java.io.File;
 import java.util.List;
 
-
 /**
  * Event sent when the app is asked to open a list of files.
  *
  * @see OpenFilesHandler#openFiles
  *
  * @since 9
  */
 public final class OpenFilesEvent extends FilesEvent {
+
     private static final long serialVersionUID = -3982871005867718956L;
     final String searchTerm;
 
     /**
-     * Constructs an {@code OpenFilesEvent}
-     * @param files files
-     * @param searchTerm searchTerm
+     * Constructs an {@code OpenFilesEvent}.
+     *
+     * @param  files the list of files
+     * @param  searchTerm the search term
+     * @throws HeadlessException if {@link GraphicsEnvironment#isHeadless()}
+     *         returns {@code true}
+     * @throws UnsupportedOperationException if Desktop API is not supported on
+     *         the current platform
+     * @see Desktop#isDesktopSupported()
+     * @see java.awt.GraphicsEnvironment#isHeadless
      */
     public OpenFilesEvent(final List<File> files, final String searchTerm) {
         super(files);
         this.searchTerm = searchTerm == null
                             ? ""

@@ -55,16 +65,15 @@
     /**
      * Gets the search term. The platform may optionally provide the search
      * term that was used to find the files. This is for example the case
      * on Mac OS X, when the files were opened using the Spotlight search
      * menu or a Finder search window.
-     *
+     * <p>
      * This is useful for highlighting the search term in the documents when
      * they are opened.
      *
      * @return the search term used to find the files
      */
     public String getSearchTerm() {
         return searchTerm;
     }
-
 }
< prev index next >