1. 首页
  2. JavaAPI

Java javax.swing Class JProgressBar（JDK8）

200 阅读 0 评论

Skip navigation links
Java™ Platform
Standard Ed. 8
javax.swing

Class JProgressBar

  • All Implemented Interfaces:
    ImageObserver, MenuContainer, Serializable, Accessible, SwingConstants 

    public class JProgressBar
extends JComponent
implements SwingConstants, Accessible
    A component that visually displays the progress of some task. As the task progresses towards completion, the progress bar displays the task's percentage of completion. This percentage is typically represented visually by a rectangle which starts out empty and gradually becomes filled in as the task progresses. In addition, the progress bar can display a textual representation of this percentage.

    JProgressBar uses a BoundedRangeModel as its data model, with the value property representing the "current" state of the task, and the minimum and maximum properties representing the beginning and end points, respectively.

    To indicate that a task of unknown length is executing, you can put a progress bar into indeterminate mode. While the bar is in indeterminate mode, it animates constantly to show that work is occurring. As soon as you can determine the task's length and amount of progress, you should update the progress bar's value and switch it back to determinate mode.

    Here is an example of creating a progress bar, where task is an object (representing some piece of work) which returns information about the progress of the task:

    progressBar = new JProgressBar(0, task.getLengthOfTask());
progressBar.setValue(0);
progressBar.setStringPainted(true);
    Here is an example of querying the current state of the task, and using the returned value to update the progress bar: 
    progressBar.setValue(task.getCurrent());
    Here is an example of putting a progress bar into indeterminate mode, and then switching back to determinate mode once the length of the task is known: 
    progressBar = new JProgressBar();
...//when the task of (initially) unknown length begins:
progressBar.setIndeterminate(true);
...//do some work; get length of task...
progressBar.setMaximum(newLength);
progressBar.setValue(newValue);
progressBar.setIndeterminate(false);

    For complete examples and further documentation see How to Monitor Progress, a section in The Java Tutorial.

    Warning: Swing is not thread safe. For more information see Swing's Threading Policy.

    Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeans™ has been added to the java.beans package. Please see XMLEncoder.

    See Also:
    BasicProgressBarUI, BoundedRangeModel, SwingWorker

    • Field Detail

      • orientation

        protected int orientation
        Whether the progress bar is horizontal or vertical. The default is HORIZONTAL.
        See Also:
        setOrientation(int)

      • paintBorder

        protected boolean paintBorder
        Whether to display a border around the progress bar. The default is true.
        See Also:
        setBorderPainted(boolean)

      • progressString

        protected String progressString
        An optional string that can be displayed on the progress bar. The default is null. Setting this to a non-null value does not imply that the string will be displayed. To display the string, paintString must be true.
        See Also:
        setString(java.lang.String), setStringPainted(boolean)

      • paintString

        protected boolean paintString
        Whether to display a string of text on the progress bar. The default is false. Setting this to true causes a textual display of the progress to be rendered on the progress bar. If the progressString is null, the percentage of completion is displayed on the progress bar. Otherwise, the progressString is rendered on the progress bar.
        See Also:
        setStringPainted(boolean), setString(java.lang.String)

      • changeEvent

        protected transient ChangeEvent changeEvent
        Only one ChangeEvent is needed per instance since the event's only interesting property is the immutable source, which is the progress bar. The event is lazily created the first time that an event notification is fired.
        See Also:
        fireStateChanged()

      • changeListener

        protected ChangeListener changeListener
        Listens for change events sent by the progress bar's model, redispatching them to change-event listeners registered upon this progress bar.
        See Also:
        createChangeListener()

    • Method Detail

      • getOrientation

        public int getOrientation()
        Returns SwingConstants.VERTICAL or SwingConstants.HORIZONTAL, depending on the orientation of the progress bar. The default orientation is SwingConstants.HORIZONTAL.
        Returns:
        HORIZONTAL or VERTICAL
        See Also:
        setOrientation(int)

      • setOrientation

        public void setOrientation(int newOrientation)
        Sets the progress bar's orientation to newOrientation, which must be SwingConstants.VERTICAL or SwingConstants.HORIZONTAL. The default orientation is SwingConstants.HORIZONTAL.
        Parameters:
        newOrientation - HORIZONTAL or VERTICAL
        Throws:
        IllegalArgumentException - if newOrientation is an illegal value
        See Also:
        getOrientation()

      • setStringPainted

        public void setStringPainted(boolean b)
        Sets the value of the stringPainted property, which determines whether the progress bar should render a progress string. The default is false, meaning no string is painted. Some look and feels might not support progress strings or might support them only when the progress bar is in determinate mode.
        Parameters:
        b - true if the progress bar should render a string
        See Also:
        isStringPainted(), setString(java.lang.String)

      • getString

        public String getString()
        Returns a String representation of the current progress. By default, this returns a simple percentage String based on the value returned from getPercentComplete. An example would be the "42%". You can change this by calling setString.
        Returns:
        the value of the progress string, or a simple percentage string if the progress string is null
        See Also:
        setString(java.lang.String)

      • setString

        public void setString(String s)
        Sets the value of the progress string. By default, this string is null, implying the built-in behavior of using a simple percent string. If you have provided a custom progress string and want to revert to the built-in behavior, set the string back to null.

        The progress string is painted only if the isStringPainted method returns true.

        Parameters:
        s - the value of the progress string
        See Also:
        getString(), setStringPainted(boolean), isStringPainted()

      • getPercentComplete

        public double getPercentComplete()
        Returns the percent complete for the progress bar. Note that this number is between 0.0 and 1.0.
        Returns:
        the percent complete for this progress bar

      • isBorderPainted

        public boolean isBorderPainted()
        Returns the borderPainted property.
        Returns:
        the value of the borderPainted property
        See Also:
        setBorderPainted(boolean)

      • setBorderPainted

        public void setBorderPainted(boolean b)
        Sets the borderPainted property, which is true if the progress bar should paint its border. The default value for this property is true. Some look and feels might not implement painted borders; they will ignore this property.
        Parameters:
        b - true if the progress bar should paint its border; otherwise, false
        See Also:
        isBorderPainted()

      • getUI

        public ProgressBarUI getUI()
        Returns the look-and-feel object that renders this component.
        Returns:
        the ProgressBarUI object that renders this component

      • createChangeListener

        protected ChangeListener createChangeListener()
        Subclasses that want to handle change events from the model differently can override this to return an instance of a custom ChangeListener implementation. The default ChangeListener simply calls the fireStateChanged method to forward ChangeEvents to the ChangeListeners that have been added directly to the progress bar.
        See Also:
        changeListener, fireStateChanged(), ChangeListener, BoundedRangeModel

      • addChangeListener

        public void addChangeListener(ChangeListener l)
        Adds the specified ChangeListener to the progress bar.
        Parameters:
        l - the ChangeListener to add

      • removeChangeListener

        public void removeChangeListener(ChangeListener l)
        Removes a ChangeListener from the progress bar.
        Parameters:
        l - the ChangeListener to remove

      • getChangeListeners

        public ChangeListener[] getChangeListeners()
        Returns an array of all the ChangeListeners added to this progress bar with addChangeListener.
        Returns:
        all of the ChangeListeners added or an empty array if no listeners have been added
        Since:
        1.4

      • fireStateChanged

        protected void fireStateChanged()
        Send a ChangeEvent, whose source is this JProgressBar, to all ChangeListeners that have registered interest in ChangeEvents. This method is called each time a ChangeEvent is received from the model.

        The event instance is created if necessary, and stored in changeEvent.

        See Also:
        addChangeListener(javax.swing.event.ChangeListener), EventListenerList

      • setModel

        public void setModel(BoundedRangeModel newModel)
        Sets the data model used by the JProgressBar. Note that the BoundedRangeModel's extent is not used, and is set to 0.
        Parameters:
        newModel - the BoundedRangeModel to use

      • getValue

        public int getValue()
        Returns the progress bar's current value from the BoundedRangeModel. The value is always between the minimum and maximum values, inclusive.
        Returns:
        the current value of the progress bar
        See Also:
        setValue(int), BoundedRangeModel.getValue()

      • setValue

        public void setValue(int n)
        Sets the progress bar's current value to n. This method forwards the new value to the model.

        The data model (an instance of BoundedRangeModel) handles any mathematical issues arising from assigning faulty values. See the BoundedRangeModel documentation for details.

        If the new value is different from the previous value, all change listeners are notified.

        Parameters:
        n - the new value
        See Also:
        getValue(), addChangeListener(javax.swing.event.ChangeListener), BoundedRangeModel.setValue(int)

      • setMinimum

        public void setMinimum(int n)
        Sets the progress bar's minimum value (stored in the progress bar's data model) to n.

        The data model (a BoundedRangeModel instance) handles any mathematical issues arising from assigning faulty values. See the BoundedRangeModel documentation for details.

        If the minimum value is different from the previous minimum, all change listeners are notified.

        Parameters:
        n - the new minimum
        See Also:
        getMinimum(), addChangeListener(javax.swing.event.ChangeListener), BoundedRangeModel.setMinimum(int)

      • setMaximum

        public void setMaximum(int n)
        Sets the progress bar's maximum value (stored in the progress bar's data model) to n.

        The underlying BoundedRangeModel handles any mathematical issues arising from assigning faulty values. See the BoundedRangeModel documentation for details.

        If the maximum value is different from the previous maximum, all change listeners are notified.

        Parameters:
        n - the new maximum
        See Also:
        getMaximum(), addChangeListener(javax.swing.event.ChangeListener), BoundedRangeModel.setMaximum(int)

      • setIndeterminate

        public void setIndeterminate(boolean newValue)
        Sets the indeterminate property of the progress bar, which determines whether the progress bar is in determinate or indeterminate mode. An indeterminate progress bar continuously displays animation indicating that an operation of unknown length is occurring. By default, this property is false. Some look and feels might not support indeterminate progress bars; they will ignore this property.

        See How to Monitor Progress for examples of using indeterminate progress bars.

        Parameters:
        newValue - true if the progress bar should change to indeterminate mode; false if it should revert to normal.
        Since:
        1.4
        See Also:
        isIndeterminate(), BasicProgressBarUI

      • isIndeterminate

        public boolean isIndeterminate()
        Returns the value of the indeterminate property.
        Returns:
        the value of the indeterminate property
        Since:
        1.4
        See Also:
        setIndeterminate(boolean)

      • paramString

        protected String paramString()
        Returns a string representation of this JProgressBar. This method is intended to be used only for debugging purposes. The content and format of the returned string may vary between implementations. The returned string may be empty but may not be null.
        Overrides:
        paramString in class JComponent
        Returns:
        a string representation of this JProgressBar

      • getAccessibleContext

        public AccessibleContext getAccessibleContext()
        Gets the AccessibleContext associated with this JProgressBar. For progress bars, the AccessibleContext takes the form of an AccessibleJProgressBar. A new AccessibleJProgressBar instance is created if necessary.
        Specified by:
        getAccessibleContext in interface Accessible
        Overrides:
        getAccessibleContext in class Component
        Returns:
        an AccessibleJProgressBar that serves as the AccessibleContext of this JProgressBar
Skip navigation links
Java™ Platform
Standard Ed. 8

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.

微信小程序

微信扫一扫体验

微信公众账号

微信扫一扫加关注

 发表
评论 返回
顶部