< 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 >