java.lang.Object
java.awt.Component
java.awt.Container
java.awt.Window
java.awt.Dialog
javax.swing.JDialog
org.jorigin.swing.task.JActivityMonitor
- All Implemented Interfaces:
ImageObserver,MenuContainer,Serializable,Accessible,RootPaneContainer,WindowConstants
A class that enables to graphically monitor tasks.
- Version:
- "1.0.14" - b202111241200L
- Author:
- Julien SEINTURIER - Université de Toulon / CNRS LIS umr 7020 - github.com/jorigin/jcommon (contact@jorigin.org)
- See Also:
-
Nested Class Summary
Nested classes/interfaces inherited from class javax.swing.JDialog
JDialog.AccessibleJDialogNested classes/interfaces inherited from class java.awt.Dialog
Dialog.AccessibleAWTDialog, Dialog.ModalExclusionType, Dialog.ModalityTypeNested classes/interfaces inherited from class java.awt.Window
Window.AccessibleAWTWindow, Window.TypeNested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainerNested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy -
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final intShow all progress flag.static final intShow the progress count flag.static final intShow the progress percent flag.Fields inherited from class javax.swing.JDialog
accessibleContext, rootPane, rootPaneCheckingEnabledFields inherited from class java.awt.Dialog
DEFAULT_MODALITY_TYPEFields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTFields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTHFields inherited from interface javax.swing.WindowConstants
DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE -
Constructor Summary
ConstructorsConstructorDescriptionJActivityMonitor(JFrame owner) Creates a new default activity monitor attached to the given owner component.JActivityMonitor(JFrame owner, boolean activityTracerVisible, boolean progressLabelVisible, boolean progressBarVisible) Create a new activity monitor. -
Method Summary
Modifier and TypeMethodDescriptionvoidDispose all active tasks displayed within the monitor.intGet the desired height of the activity tracer in pixels.intGet the desired height of the progress bars in pixels.intGet the desired height of the progress labels in pixels.voidinit(boolean activityVisible, boolean progressBarVisible) Init the activity monitor.protected voidinitGUI()Initialize the Graphical User Interface (GUI) components.booleanGet if the activity tracer that log progress details is visible.booleanGet if the persistence check box is visible.booleanGet the persistence value of the activity monitor.booleanGet if the progress bars are visible.booleanGet if the progress labels (textual labels above progress bars) are visible.booleanSet if the progression labels has to be visible.booleanIs the monitor use new line for writing task informations.voidprocessTaskEvent(TaskEvent event) Process a task event.voidprocessTaskEvent(TaskEvent event, boolean progressBarVisible) Process a task event.protected voidRefresh the graphical user interface components.voidsetActivityTracerHeight(int height) Set the the desired height of the activity tracer in pixels.voidsetActivityTracerVisible(boolean visible) Set if the activity tracer that log progress details has to be visible.voidsetPersistenceCheckBoxVisible(boolean visible) Set if the persistence check box has to be visible.voidsetPersistent(boolean isPersistent) Specify if the activity monitor is persistent.voidsetProgressBarHeight(int height) Set the desired height of the progress bars in pixels.voidsetProgressBarVisible(boolean visible) Set if the progress bars are visible.voidsetProgressLabelHeight(int height) Set the desired height of the progress labels in pixels.voidsetProgressLabelVisible(boolean visible) Set if the progress labels (textual labels above progress bars) are visible.voidsetShowProgressionText(boolean showProgressionText) Get if the progression labels are visible.voidsetUseNewLine(boolean useNewLine) Set if the monitor use new line for writing task informations.Methods inherited from class javax.swing.JDialog
addImpl, createRootPane, dialogInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getRootPane, getTransferHandler, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, repaint, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, setTransferHandler, updateMethods inherited from class java.awt.Dialog
addNotify, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setBackground, setModal, setModalityType, setOpacity, setResizable, setShape, setTitle, setUndecorated, setVisible, show, toBackMethods inherited from class java.awt.Window
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, toFrontMethods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, validate, validateTreeMethods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setMixingCutoutShape, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
Field Details
-
SHOW_PROGRESS_PERCENT
public static final int SHOW_PROGRESS_PERCENTShow the progress percent flag.- See Also:
-
SHOW_PROGRESS_COUNT
public static final int SHOW_PROGRESS_COUNTShow the progress count flag.- See Also:
-
SHOW_PROGRESS_ALL
public static final int SHOW_PROGRESS_ALLShow all progress flag.- See Also:
-
-
Constructor Details
-
JActivityMonitor
public JActivityMonitor(JFrame owner, boolean activityTracerVisible, boolean progressLabelVisible, boolean progressBarVisible) Create a new activity monitor.- Parameters:
owner- the owner of the component.activityTracerVisible- is the activity tracer has to be visible.progressLabelVisible- is the progress labels have to be visible.progressBarVisible- is the progress bars have to be visible.
-
JActivityMonitor
Creates a new default activity monitor attached to the given owner component.- Parameters:
owner- the owner component.
-
-
Method Details
-
isUseNewLine
public boolean isUseNewLine()Is the monitor use new line for writing task informations.- Returns:
trueif the monitor has to use new line for writing task information offalseotherwise.- See Also:
-
setUseNewLine
public void setUseNewLine(boolean useNewLine) Set if the monitor use new line for writing task informations.- Parameters:
useNewLine-trueif the monitor has to use new line for writing task information offalseotherwise.- See Also:
-
getActivityTracerHeight
public int getActivityTracerHeight()Get the desired height of the activity tracer in pixels.- Returns:
- the desired height of the activity tracer in pixels.
- See Also:
-
setActivityTracerHeight
public void setActivityTracerHeight(int height) Set the the desired height of the activity tracer in pixels.- Parameters:
height- the the desired height of the activity tracer in pixels.- See Also:
-
getProgressBarHeight
public int getProgressBarHeight()Get the desired height of the progress bars in pixels.- Returns:
- the desired height of the progress bars in pixels.
- See Also:
-
setProgressBarHeight
public void setProgressBarHeight(int height) Set the desired height of the progress bars in pixels.- Parameters:
height- the desired height of the progress bars in pixels.- See Also:
-
getProgressLabelHeight
public int getProgressLabelHeight()Get the desired height of the progress labels in pixels.- Returns:
- the desired height of the progress labels in pixels.
- See Also:
-
setProgressLabelHeight
public void setProgressLabelHeight(int height) Set the desired height of the progress labels in pixels.- Parameters:
height- the desired height of the progress labels in pixels.- See Also:
-
isActivityTracerVisible
public boolean isActivityTracerVisible()Get if the activity tracer that log progress details is visible.- Returns:
trueif the text area that log progress details is visible andfalseotherwise.- See Also:
-
setActivityTracerVisible
public void setActivityTracerVisible(boolean visible) Set if the activity tracer that log progress details has to be visible.- Parameters:
visible-trueif the text area that log progress details has to be visible andfalseotherwise.- See Also:
-
isPersistenceCheckBoxVisible
public boolean isPersistenceCheckBoxVisible()Get if the persistence check box is visible.- Returns:
trueif the persistence check box is visible andfalseotherwise.- See Also:
-
setPersistenceCheckBoxVisible
public void setPersistenceCheckBoxVisible(boolean visible) Set if the persistence check box has to be visible.- Parameters:
visible-trueif the persistence check box is visible andfalseotherwise.- See Also:
-
isProgessLabelVisible
public boolean isProgessLabelVisible()Get if the progress labels (textual labels above progress bars) are visible.- Returns:
trueif the progress label are visible andfalseotherwise.- See Also:
-
setProgressLabelVisible
public void setProgressLabelVisible(boolean visible) Set if the progress labels (textual labels above progress bars) are visible.- Parameters:
visible-trueif the progress label are visible andfalseotherwise.- See Also:
-
isProgessBarVisible
public boolean isProgessBarVisible()Get if the progress bars are visible.- Returns:
trueif the progress bar are visible andfalseotherwise.- See Also:
-
setProgressBarVisible
public void setProgressBarVisible(boolean visible) Set if the progress bars are visible.- Parameters:
visible-trueif the progress bar are visible andfalseotherwise.- See Also:
-
isShowProgressionText
public boolean isShowProgressionText()Set if the progression labels has to be visible.- Returns:
trueif the progression labels are visible andfalseotherwise.- See Also:
-
setShowProgressionText
public void setShowProgressionText(boolean showProgressionText) Get if the progression labels are visible.- Parameters:
showProgressionText-trueif the progression labels are visible andfalseotherwise.- See Also:
-
setPersistent
public void setPersistent(boolean isPersistent) Specify if the activity monitor is persistent. If it's the case, the monitor is always displayed. If theisPersistentvalue is equals to false, the activity monitor is hiden when all monitored tasks are finished.- Parameters:
isPersistent- the persistence value of the activity monitor
-
isPersistent
public boolean isPersistent()Get the persistence value of the activity monitor. If theisPersistentvalue is equals to false, the activity monitor is hiden when all monitored tasks are finished. Otherwise, the monotor is always visible.- Returns:
- the persistence value of the monitor.
-
initGUI
protected void initGUI()Initialize the Graphical User Interface (GUI) components. -
refreshGUI
protected void refreshGUI()Refresh the graphical user interface components. -
init
public void init(boolean activityVisible, boolean progressBarVisible) Init the activity monitor.- Parameters:
activityVisible- is the activity tracer is visible.progressBarVisible- is the progress bar is visible.
-
processTaskEvent
Process a task event.- Parameters:
event- The task Event to process.- See Also:
-
processTaskEvent
Process a task event. The booleanprogressBarVisiblecan be used to override theisProgessBarVisible()andisProgessLabelVisible()values for the specified task.- Parameters:
event- The task Event to process.progressBarVisible-trueif a task progress (progress bar plus label) has to be created for this task.
-
disposeTasks
public void disposeTasks()Dispose all active tasks displayed within the monitor. You can use this method is the monitored process has failed.
-