< prev index next >

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

Print this page

        

@@ -89,11 +89,11 @@
          */
         MENU,
 
         /**
          * Represents a progress state feature for a specified window.
-         * @see #setWindowProgressState(java.awt.Window, State)
+         * @see #setWindowProgressState(java.awt.Frame, State)
          */
         PROGRESS_STATE_WINDOW,
 
         /**
          * Represents a progress value feature.

@@ -101,11 +101,11 @@
          */
         PROGRESS_VALUE,
 
         /**
          * Represents a progress value feature for a specified window.
-         * @see #setWindowProgressValue(java.awt.Window, int)
+         * @see #setWindowProgressValue(java.awt.Frame, int)
          */
         PROGRESS_VALUE_WINDOW,
 
         /**
          * Represents a user attention request feature.

@@ -113,19 +113,19 @@
          */
         USER_ATTENTION,
 
         /**
          * Represents a user attention request feature for a specified window.
-         * @see #requestWindowUserAttention(java.awt.Window)
+         * @see #requestWindowUserAttention(java.awt.Frame)
          */
         USER_ATTENTION_WINDOW
     }
 
     /**
      * Kinds of available window progress states.
      *
-     * @see #setWindowProgressState(java.awt.Window, java.awt.Taskbar.State)
+     * @see #setWindowProgressState(java.awt.Frame, java.awt.Taskbar.State)
      */
     public static enum State {
         /**
          * Stops displaying the progress.
          */

@@ -272,17 +272,19 @@
     }
 
     /**
      * Requests user attention to the specified window.
      *
+     * Has no effect if this window is not visible in the task area.
+     *
      * @param w window
      * @throws SecurityException if a security manager exists and it denies the
      * {@code RuntimePermission("canProcessApplicationEvents")} permission.
      * @throws UnsupportedOperationException if the current platform
      * does not support the {@link Taskbar.Feature#USER_ATTENTION_WINDOW} feature
      */
-    public void requestWindowUserAttention(Window w) {
+    public void requestWindowUserAttention(Frame w) {
         checkEventsProcessingPermission();
         checkFeatureSupport(Feature.USER_ATTENTION_WINDOW);
         peer.requestWindowUserAttention(w);
     }
 

@@ -373,18 +375,20 @@
     /**
      * Affixes a small badge to this application's icon in the task area
      * for the specified window.
      * It may be disabled by system settings.
      *
+     * Has no effect if this window is not visible in the task area.
+     *
      * @param w window to update
      * @param badge image to affix to the icon
      * @throws SecurityException if a security manager exists and it denies the
      * {@code RuntimePermission("canProcessApplicationEvents")} permission.
      * @throws UnsupportedOperationException if the current platform
      * does not support the {@link Taskbar.Feature#ICON_BADGE_IMAGE_WINDOW} feature
      */
-    public void setWindowIconBadge(Window w, final Image badge) {
+    public void setWindowIconBadge(Frame w, final Image badge) {
         checkEventsProcessingPermission();
         checkFeatureSupport(Feature.ICON_BADGE_IMAGE_WINDOW);
         if (w != null) {
             peer.setWindowIconBadge(w, badge);
         }

@@ -407,10 +411,12 @@
     }
 
     /**
      * Displays a determinate progress bar in the task area for the specified
      * window.
+     *
+     * Has no effect if this window is not visible in the task area.
      * <br>
      * The visual behavior is platform and {@link State} dependent.
      * <br>
      * This call cancels the {@link State#INDETERMINATE INDETERMINATE} state
      * of the window.

@@ -419,26 +425,28 @@
      * the behavior is platform specific.
      *
      * @param w window to update
      * @param value from 0 to 100, other to switch to {@link State#OFF} state
      *              and disable progress indication
-     * @see #setWindowProgressState(java.awt.Window, State)
+     * @see #setWindowProgressState(java.awt.Frame, State)
      * @throws SecurityException if a security manager exists and it denies the
      * {@code RuntimePermission("canProcessApplicationEvents")} permission.
      * @throws UnsupportedOperationException if the current platform
      * does not support the {@link Taskbar.Feature#PROGRESS_VALUE_WINDOW} feature
      */
-    public void setWindowProgressValue(Window w, int value) {
+    public void setWindowProgressValue(Frame w, int value) {
         checkEventsProcessingPermission();
         checkFeatureSupport(Feature.PROGRESS_VALUE_WINDOW);
         if (w != null) {
             peer.setWindowProgressValue(w, value);
         }
     }
 
     /**
      * Sets a progress state for a specified window.
+     *
+     * Has no effect if this window is not visible in the task area.
      * <br>
      * Each state displays a progress in a platform-dependent way.
      * <br>
      * Note than switching from {@link State#INDETERMINATE INDETERMINATE} state
      * to any of determinate states may reset value set by

@@ -449,17 +457,17 @@
      * @see State#OFF
      * @see State#NORMAL
      * @see State#PAUSED
      * @see State#ERROR
      * @see State#INDETERMINATE
-     * @see #setWindowProgressValue(java.awt.Window, int)
+     * @see #setWindowProgressValue(java.awt.Frame, int)
      * @throws SecurityException if a security manager exists and it denies the
      * {@code RuntimePermission("canProcessApplicationEvents")} permission.
      * @throws UnsupportedOperationException if the current platform
      * does not support the {@link Taskbar.Feature#PROGRESS_STATE_WINDOW} feature
      */
-    public void setWindowProgressState(Window w, State state) {
+    public void setWindowProgressState(Frame w, State state) {
         checkEventsProcessingPermission();
         checkFeatureSupport(Feature.PROGRESS_STATE_WINDOW);
         if (w != null) {
             peer.setWindowProgressState(w, state);
         }
< prev index next >