< 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,288 ****
}
/**
* 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);
}
--- 272,290 ----
}
/**
* 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(Frame w) {
checkEventsProcessingPermission();
checkFeatureSupport(Feature.USER_ATTENTION_WINDOW);
peer.requestWindowUserAttention(w);
}
*** 373,390 ****
/**
* 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,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.
*
+ * 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(Frame w, final Image badge) {
checkEventsProcessingPermission();
checkFeatureSupport(Feature.ICON_BADGE_IMAGE_WINDOW);
if (w != null) {
peer.setWindowIconBadge(w, badge);
}
*** 407,416 ****
--- 411,422 ----
}
/**
* 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,444 ****
* 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
--- 425,452 ----
* 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.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 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,465 ****
* @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);
}
--- 457,473 ----
* @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 w, State state) {
checkEventsProcessingPermission();
checkFeatureSupport(Feature.PROGRESS_STATE_WINDOW);
if (w != null) {
peer.setWindowProgressState(w, state);
}
< prev index next >