< prev index next >

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

Print this page

        

*** 89,99 **** */ MENU, /** * Represents a progress state feature for a specified window. ! * @see #setWindowProgressState(java.awt.Window, State) */ PROGRESS_STATE_WINDOW, /** * Represents a progress value feature. --- 89,99 ---- */ MENU, /** * Represents a progress state feature for a specified window. ! * @see #setWindowProgressState(java.awt.Frame, State) */ PROGRESS_STATE_WINDOW, /** * Represents a progress value feature.
*** 101,111 **** */ PROGRESS_VALUE, /** * Represents a progress value feature for a specified window. ! * @see #setWindowProgressValue(java.awt.Window, int) */ PROGRESS_VALUE_WINDOW, /** * Represents a user attention request feature. --- 101,111 ---- */ PROGRESS_VALUE, /** * Represents a progress value feature for a specified window. ! * @see #setWindowProgressValue(java.awt.Frame, int) */ PROGRESS_VALUE_WINDOW, /** * Represents a user attention request feature.
*** 113,131 **** */ USER_ATTENTION, /** * Represents a user attention request feature for a specified window. ! * @see #requestWindowUserAttention(java.awt.Window) */ USER_ATTENTION_WINDOW } /** * Kinds of available window progress states. * ! * @see #setWindowProgressState(java.awt.Window, java.awt.Taskbar.State) */ public static enum State { /** * Stops displaying the progress. */ --- 113,131 ---- */ USER_ATTENTION, /** * Represents a user attention request feature for a specified window. ! * @see #requestWindowUserAttention(java.awt.Frame) */ USER_ATTENTION_WINDOW } /** * Kinds of available window progress states. * ! * @see #setWindowProgressState(java.awt.Frame, java.awt.Taskbar.State) */ public static enum State { /** * Stops displaying the progress. */
*** 272,291 **** } /** * Requests user attention to the specified window. * ! * @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) { checkEventsProcessingPermission(); checkFeatureSupport(Feature.USER_ATTENTION_WINDOW); ! peer.requestWindowUserAttention(w); } /** * Attaches the contents of the provided PopupMenu to the application icon * in the task area. --- 272,293 ---- } /** * Requests user attention to the specified window. * ! * Has no effect if this window is not visible in the task area. ! * ! * @param f Frame * @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(Frame f) { checkEventsProcessingPermission(); checkFeatureSupport(Feature.USER_ATTENTION_WINDOW); ! peer.requestWindowUserAttention(f); } /** * Attaches the contents of the provided PopupMenu to the application icon * in the task area.
*** 373,394 **** /** * Affixes a small badge to this application's icon in the task area * for the specified window. * It may be disabled by system settings. * ! * @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) { checkEventsProcessingPermission(); checkFeatureSupport(Feature.ICON_BADGE_IMAGE_WINDOW); ! if (w != null) { ! peer.setWindowIconBadge(w, badge); } } /** --- 375,398 ---- /** * 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 f frame 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(Frame f, final Image badge) { checkEventsProcessingPermission(); checkFeatureSupport(Feature.ICON_BADGE_IMAGE_WINDOW); ! if (f != null) { ! peer.setWindowIconBadge(f, badge); } } /**
*** 407,467 **** } /** * Displays a determinate progress bar in the task area for the specified * window. * <br> * The visual behavior is platform and {@link State} dependent. * <br> * This call cancels the {@link State#INDETERMINATE INDETERMINATE} state * of the window. * <br> * Note that when multiple windows is grouped in the task area * 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) * @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) { checkEventsProcessingPermission(); checkFeatureSupport(Feature.PROGRESS_VALUE_WINDOW); ! if (w != null) { ! peer.setWindowProgressValue(w, value); } } /** * Sets a progress state for a specified window. * <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 * {@link #setWindowProgressValue(java.awt.Window, int) setWindowProgressValue} * ! * @param w window * @param state to change to * @see State#OFF * @see State#NORMAL * @see State#PAUSED * @see State#ERROR * @see State#INDETERMINATE ! * @see #setWindowProgressValue(java.awt.Window, 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) { checkEventsProcessingPermission(); checkFeatureSupport(Feature.PROGRESS_STATE_WINDOW); ! if (w != null) { ! peer.setWindowProgressState(w, state); } } } --- 411,475 ---- } /** * 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. * <br> * Note that when multiple windows is grouped in the task area * the behavior is platform specific. * ! * @param f frame to update * @param value from 0 to 100, other to switch to {@link State#OFF} state * and disable progress indication ! * @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(Frame f, int value) { checkEventsProcessingPermission(); checkFeatureSupport(Feature.PROGRESS_VALUE_WINDOW); ! if (f != null) { ! peer.setWindowProgressValue(f, 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 * {@link #setWindowProgressValue(java.awt.Window, int) setWindowProgressValue} * ! * @param f frame * @param state to change to * @see State#OFF * @see State#NORMAL * @see State#PAUSED * @see State#ERROR * @see State#INDETERMINATE ! * @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(Frame f, State state) { checkEventsProcessingPermission(); checkFeatureSupport(Feature.PROGRESS_STATE_WINDOW); ! if (f != null) { ! peer.setWindowProgressState(f, state); } } }
< prev index next >