JProgressBar (Java Platform SE 6) - xrath.com 에서 번역됨

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요 : 상자 | 필드 | 생성자 | 메소드

상세 : 필드 | 생성자 | 메소드

javax.swing
클래스 JProgressBar

java.lang.Object 
  java.awt.Component 
      java.awt.Container 
          javax.swing.JComponent 
              javax.swing.JProgressBar

모든 구현된 인터페이스:: ImageObserver , MenuContainer , Serializable , Accessible , SwingConstants

public class JProgressBar
extends JComponent
implements SwingConstants , Accessible
extends JComponent
implements SwingConstants , Accessible

일부의 태스크의 진척 상황을 시각적으로 표시하는 컴퍼넌트입니다. 태스크의 처리의 진행에 맞추어, 진척 바에, 처리의 완료의 퍼센티지가 표시됩니다. 이 퍼센티지는, 일반적으로, 막대 모양의 인디케이터(indicator)로 나타내집니다. 최초, 이 인디케이터(indicator)의 내부는 빈 상태(empty)입니다만, 처리의 진행과 함께 전부 칠해져 갑니다. 진척 바에는, 이 퍼센티지를 텍스트로 표시할 수도 있습니다.

JProgressBar 는,BoundedRangeModel 를 데이터 모델로 해, 태스크의 「현재의」상태를 나타내는 value 프로퍼티, 태스크의 개시점을 나타내는 minimum 프로퍼티, 및 태스크의 종료점을 나타내는 maximum 프로퍼티을 지정해 사용합니다.

불명한 길이의 태스크가 실행되고 있는 것을 나타내려면 , 진척 바를 불확정 모드로 할 수 있습니다. 바가 불확정 모드의 사이는, 항상 처리를 하고 있는 것이 동영상으로 표시됩니다. 태스크의 길이가 판정되자마자, 진척 바의 값을 갱신해 확정 모드에 되돌립니다.

진척 바의 작성예를 다음에 나타냅니다. task 는 처리의 진척 상황을 돌려주는 객체로, 작업 내용의 일부를 나타냅니다.

progressBar = new JProgressBar(0, task.getLengthOfTask());
progressBar.setValue(0);
progressBar.setStringPainted(true);

태스크의 현재 상태를 문의해 반환값을 사용해 진척 바를 갱신하는 예를 다음에 나타냅니다.

progressBar.setValue(task.getCurrent());

진척 바를 불확정 모드로 해, 태스크의 길이가 판명되면(자) 확정 모드에 되돌리는 예입니다.

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

상세한 예 및 해설에 대해서는, 「The Java Tutorial」의 섹션「How to Monitor Progress」를 참조해 주세요.

경고: Swing 는 thread에 대해서 안전하지는 않습니다. 자세한 것은,「Swing's Threading Policy」를 참조해 주세요.

경고: 이 클래스의 직렬화 된 객체는, 향후의 Swing 릴리스와 호환은 아니게 될 예정입니다. 현재의 직렬화의 지원는, 단기간의 운용이나, 같은 버젼의 Swing 를 실행하는 어플리케이션간의 RMI 에 적절하고 있습니다. JDK Version 1.4 이후, 모든 JavaBeans^™ 의 장기간의 운용 지원는,java.beans 패키지에 추가되고 있습니다. 자세한 것은,XMLEncoder 를 참조해 주세요.

관련 항목:: BasicProgressBarUI , BoundedRangeModel , SwingWorker

상자의 클래스의 개요
`protected class`	`JProgressBar.AccessibleJProgressBar` 이 클래스는 `JProgressBar` 클래스용의 접근성? 지원를 구현하고 있습니다.

클래스 javax.swing. JComponent 로부터 상속된 상자의 클래스/인터페이스
`JComponent.AccessibleJComponent`

클래스 java.awt. Container 로부터 상속된 상자의 클래스/인터페이스
`Container.AccessibleAWTContainer`

클래스 java.awt. Component 로부터 상속된 상자의 클래스/인터페이스
`Component.AccessibleAWTComponent , Component.BaselineResizeBehavior , Component.BltBufferStrategy , Component.FlipBufferStrategy`

필드의 개요
`protected ChangeEvent`	`changeEvent` `ChangeEvent` 는, 인스턴스 마다 1 개(살)만 필요합니다.
`protected ChangeListener`	`changeListener` 진척 바의 모델로부터 보내진 변경 이벤트를 대기해, 이 진척 바에 등록된 변경 이벤트 청취자에게 다시 발송 합니다.
`protected BoundedRangeModel`	`model` 진척 바의 값을 보관 유지하는 객체입니다.
`protected int`	`orientation` 진척 바가 수평일까 수직인지를 나타냅니다.
`protected boolean`	`paintBorder` 진척 바의 주위에 경계를 표시할지 어떨지를 나타냅니다.
`protected boolean`	`paintString` 진척 바에 캐릭터 라인을 표시할지 어떨지를 설정합니다.
`protected String`	`progressString` 진척 바에 표시할 수 있는 임의 지정의 캐릭터 라인입니다.

클래스 javax.swing. JComponent 로부터 상속된 필드
`accessibleContext , listenerList , TOOL_TIP_TEXT_KEY , ui , UNDEFINED_CONDITION , WHEN_ANCESTOR_OF_FOCUSED_COMPONENT , WHEN_FOCUSED , WHEN_IN_FOCUSED_WINDOW`

클래스 java.awt. Component 로부터 상속된 필드
`BOTTOM_ALIGNMENT , CENTER_ALIGNMENT , LEFT_ALIGNMENT , RIGHT_ALIGNMENT , TOP_ALIGNMENT`

인터페이스 javax.swing. SwingConstants 로부터 상속된 필드
`BOTTOM , CENTER , EAST , HORIZONTAL , LEADING , LEFT , NEXT , NORTH , NORTH_EAST , NORTH_WEST , PREVIOUS , RIGHT , SOUTH , SOUTH_EAST , SOUTH_WEST , TOP , TRAILING , VERTICAL , WEST`

인터페이스 java.awt.image. ImageObserver 로부터 상속된 필드
`ABORT , ALLBITS , ERROR , FRAMEBITS , HEIGHT , PROPERTIES , SOMEBITS , WIDTH`

생성자 의 개요
`JProgressBar ()` 경계를 표시해, 진척 캐릭터 라인을 표시하지 않는, 수평 방향의 진척 바를 작성합니다.
`JProgressBar (BoundedRangeModel newModel)` 수평 방향의 진척 바를 작성합니다.
`JProgressBar (int orient)` 지정한 방향 (`SwingConstants.VERTICAL` 또는 `SwingConstants.HORIZONTAL`)으로 진척 바를 작성합니다.
`JProgressBar (int min, int max)` 수평 방향의 진척 바를 작성합니다.
`JProgressBar (int orient, int min, int max)` 진척 바를 작성합니다.

메소드의 개요
`void`	`addChangeListener (ChangeListener l)` 지정된 `ChangeListener` 를 진척 바에 추가합니다.
`protected ChangeListener`	`createChangeListener ()` 서브 클래스가 다른 방법으로 변경 이벤트를 처리하는 경우는, 이 메소드를 오버라이드(override) 해 독자적인 `ChangeListener` 의 구현의 인스턴스를 돌려줄 수가 있습니다.
`protected void`	`fireStateChanged ()` 이 `JProgressBar` 를 소스로 하는 `ChangeEvent` 를,`ChangeEvent` 의 통지를 받는 등록을 하고 있는 모든 `ChangeListener` 에 송신합니다.
`AccessibleContext`	`getAccessibleContext ()` 이 `JProgressBar` 에 관련한 `AccessibleContext` 를 돌려줍니다.
`ChangeListener []`	`getChangeListeners ()` 이 진척 바에 `addChangeListener` 로 추가된 모든 `ChangeListener` 의 배열을 돌려줍니다.
`int`	`getMaximum ()` `BoundedRangeModel` 의 진척 바의 현재의 `최대` 치를 돌려줍니다.
`int`	`getMinimum ()` `BoundedRangeModel` 의 진척 바의 현재의 `최소` 치를 돌려줍니다.
`BoundedRangeModel`	`getModel ()` 이 진척 바가 사용하고 있는 데이터 모델을 돌려줍니다.
`int`	`getOrientation ()` 진척 바의 방향으로 응해,`SwingConstants.VERTICAL` 나 `SwingConstants.HORIZONTAL` 를 돌려줍니다.
`double`	`getPercentComplete ()` 진척 바의 완료한 퍼센트를 돌려줍니다.
`String`	`getString ()` 현재의 진척 상황을 나타내는 `String` 표현을 돌려줍니다.
`ProgressBarUI`	`getUI ()` 이 컴퍼넌트를 draw 하는 Look & Feel 객체를 돌려줍니다.
`String`	`getUIClassID ()` 이 컴퍼넌트를 draw 하는 Look & Feel 클래스의 이름을 돌려줍니다.
`int`	`getValue ()` `BoundedRangeModel` 의 진척 바의 현재의 `값` 을 돌려줍니다.
`boolean`	`isBorderPainted ()` `borderPainted` 프로퍼티을 돌려줍니다.
`boolean`	`isIndeterminate ()` `indeterminate` 프로퍼티의 값을 돌려줍니다.
`boolean`	`isStringPainted ()` `stringPainted` 프로퍼티의 값을 돌려줍니다.
`protected void`	`paintBorder (Graphics g)` `borderPainted` 프로퍼티이 `true` 인 경우에, 진척 바에 경계를 그립니다.
`protected String`	`paramString ()` 이 `JProgressBar` 의 캐릭터 라인 표현을 돌려줍니다.
`void`	`removeChangeListener (ChangeListener l)` 진척 바로부터 `ChangeListener` 를 삭제합니다.
`void`	`setBorderPainted (boolean b)` 진척 바가 경계를 페인트 하도록(듯이) 하려면 `true` 로 할 필요가 있습니다.
`void`	`setIndeterminate (boolean newValue)` 진척 바의 `indeterminate` 프로퍼티의 값을 설정합니다.
`void`	`setMaximum (int n)` 진척 바의 최대치 (진척 바의 데이터 모델에 포함)를 `n` 로 설정합니다.
`void`	`setMinimum (int n)` 진척 바의 최소치 (진척 바의 데이터 모델에 포함)를 `n` 로 설정합니다.
`void`	`setModel (BoundedRangeModel newModel)` `JProgressBar` 가 사용하는 데이터 모델을 설정합니다.
`void`	`setOrientation (int newOrientation)` 진척 바의 방향을 `newOrientation` (`SwingConstants.VERTICAL` 또는 `SwingConstants.HORIZONTAL`)로 설정합니다.
`void`	`setString (String s)` 진척 캐릭터 라인의 값을 설정합니다.
`void`	`setStringPainted (boolean b)` `stringPainted` 프로퍼티의 값을 설정합니다.
`void`	`setUI (ProgressBarUI ui)` 이 컴퍼넌트를 draw 하는 Look & Feel 객체를 설정합니다.
`void`	`setValue (int n)` 진척 바의 현재의 값을 `n` 로 설정합니다.
`void`	`updateUI ()` 현재의 Look & Feel 로부터의 값에 UI 프로퍼티을 리셋 합니다.

클래스 javax.swing. JComponent 로부터 상속된 메소드
addAncestorListener , addNotify , addVetoableChangeListener , computeVisibleRect , contains , createToolTip , disable , enable , firePropertyChange , firePropertyChange , firePropertyChange , fireVetoableChange , getActionForKeyStroke , getActionMap , getAlignmentX , getAlignmentY , getAncestorListeners , getAutoscrolls , getBaseline , getBaselineResizeBehavior , getBorder , getBounds , getClientProperty , getComponentGraphics , getComponentPopupMenu , getConditionForKeyStroke , getDebugGraphicsOptions , getDefaultLocale , getFontMetrics , getGraphics , getHeight , getInheritsPopupMenu , getInputMap , getInputMap , getInputVerifier , getInsets , getInsets , getListeners , getLocation , getMaximumSize , getMinimumSize , getNextFocusableComponent , getPopupLocation , getPreferredSize , getRegisteredKeyStrokes , getRootPane , getSize , getToolTipLocation , getToolTipText , getToolTipText , getTopLevelAncestor , getTransferHandler , getVerifyInputWhenFocusTarget , getVetoableChangeListeners , getVisibleRect , getWidth , getX , getY , grabFocus , isDoubleBuffered , isLightweightComponent , isManagingFocus , isOpaque , isOptimizedDrawingEnabled , isPaintingForPrint , isPaintingTile , isRequestFocusEnabled , isValidateRoot , paint , paintChildren , paintComponent , paintImmediately , paintImmediately , print , printAll , printBorder , printChildren , printComponent , processComponentKeyEvent , processKeyBinding , processKeyEvent , processMouseEvent , processMouseMotionEvent , putClientProperty , registerKeyboardAction , registerKeyboardAction , removeAncestorListener , removeNotify , removeVetoableChangeListener , repaint , repaint , requestDefaultFocus , requestFocus , requestFocus , requestFocusInWindow , requestFocusInWindow , resetKeyboardActions , reshape , revalidate , scrollRectToVisible , setActionMap , setAlignmentX , setAlignmentY , setAutoscrolls , setBackground , setBorder , setComponentPopupMenu , setDebugGraphicsOptions , setDefaultLocale , setDoubleBuffered , setEnabled , setFocusTraversalKeys , setFont , setForeground , setInheritsPopupMenu , setInputMap , setInputVerifier , setMaximumSize , setMinimumSize , setNextFocusableComponent , setOpaque , setPreferredSize , setRequestFocusEnabled , setToolTipText , setTransferHandler , setUI , setVerifyInputWhenFocusTarget , setVisible , unregisterKeyboardAction , update

클래스 javax.swing. JComponent 로부터 상속된 메소드

addAncestorListener , addNotify , addVetoableChangeListener , computeVisibleRect , contains , createToolTip , disable , enable , firePropertyChange , firePropertyChange , firePropertyChange , fireVetoableChange , getActionForKeyStroke , getActionMap , getAlignmentX , getAlignmentY , getAncestorListeners , getAutoscrolls , getBaseline , getBaselineResizeBehavior , getBorder , getBounds , getClientProperty , getComponentGraphics , getComponentPopupMenu , getConditionForKeyStroke , getDebugGraphicsOptions , getDefaultLocale , getFontMetrics , getGraphics , getHeight , getInheritsPopupMenu , getInputMap , getInputMap , getInputVerifier , getInsets , getInsets , getListeners , getLocation , getMaximumSize , getMinimumSize , getNextFocusableComponent , getPopupLocation , getPreferredSize , getRegisteredKeyStrokes , getRootPane , getSize , getToolTipLocation , getToolTipText , getToolTipText , getTopLevelAncestor , getTransferHandler , getVerifyInputWhenFocusTarget , getVetoableChangeListeners , getVisibleRect , getWidth , getX , getY , grabFocus , isDoubleBuffered , isLightweightComponent , isManagingFocus , isOpaque , isOptimizedDrawingEnabled , isPaintingForPrint , isPaintingTile , isRequestFocusEnabled , isValidateRoot , paint , paintChildren , paintComponent , paintImmediately , paintImmediately , print , printAll , printBorder , printChildren , printComponent , processComponentKeyEvent , processKeyBinding , processKeyEvent , processMouseEvent , processMouseMotionEvent , putClientProperty , registerKeyboardAction , registerKeyboardAction , removeAncestorListener , removeNotify , removeVetoableChangeListener , repaint , repaint , requestDefaultFocus , requestFocus , requestFocus , requestFocusInWindow , requestFocusInWindow , resetKeyboardActions , reshape , revalidate , scrollRectToVisible , setActionMap , setAlignmentX , setAlignmentY , setAutoscrolls , setBackground , setBorder , setComponentPopupMenu , setDebugGraphicsOptions , setDefaultLocale , setDoubleBuffered , setEnabled , setFocusTraversalKeys , setFont , setForeground , setInheritsPopupMenu , setInputMap , setInputVerifier , setMaximumSize , setMinimumSize , setNextFocusableComponent , setOpaque , setPreferredSize , setRequestFocusEnabled , setToolTipText , setTransferHandler , setUI , setVerifyInputWhenFocusTarget , setVisible , unregisterKeyboardAction , update

클래스 java.awt. Container 로부터 상속된 메소드
add , add , add , add , add , addContainerListener , addImpl , addPropertyChangeListener , addPropertyChangeListener , applyComponentOrientation , areFocusTraversalKeysSet , countComponents , deliverEvent , doLayout , findComponentAt , findComponentAt , getComponent , getComponentAt , getComponentAt , getComponentCount , getComponents , getComponentZOrder , getContainerListeners , getFocusTraversalKeys , getFocusTraversalPolicy , getLayout , getMousePosition , insets , invalidate , isAncestorOf , isFocusCycleRoot , isFocusCycleRoot , isFocusTraversalPolicyProvider , isFocusTraversalPolicySet , layout , list , list , locate , minimumSize , paintComponents , preferredSize , printComponents , processContainerEvent , processEvent , remove , remove , removeAll , removeContainerListener , setComponentZOrder , setFocusCycleRoot , setFocusTraversalPolicy , setFocusTraversalPolicyProvider , setLayout , transferFocusBackward , transferFocusDownCycle , validate , validateTree

클래스 java.awt. Container 로부터 상속된 메소드

add , add , add , add , add , addContainerListener , addImpl , addPropertyChangeListener , addPropertyChangeListener , applyComponentOrientation , areFocusTraversalKeysSet , countComponents , deliverEvent , doLayout , findComponentAt , findComponentAt , getComponent , getComponentAt , getComponentAt , getComponentCount , getComponents , getComponentZOrder , getContainerListeners , getFocusTraversalKeys , getFocusTraversalPolicy , getLayout , getMousePosition , insets , invalidate , isAncestorOf , isFocusCycleRoot , isFocusCycleRoot , isFocusTraversalPolicyProvider , isFocusTraversalPolicySet , layout , list , list , locate , minimumSize , paintComponents , preferredSize , printComponents , processContainerEvent , processEvent , remove , remove , removeAll , removeContainerListener , setComponentZOrder , setFocusCycleRoot , setFocusTraversalPolicy , setFocusTraversalPolicyProvider , setLayout , transferFocusBackward , transferFocusDownCycle , validate , validateTree

클래스 java.awt. Component 로부터 상속된 메소드
action , add , addComponentListener , addFocusListener , addHierarchyBoundsListener , addHierarchyListener , addInputMethodListener , addKeyListener , addMouseListener , addMouseMotionListener , addMouseWheelListener , bounds , checkImage , checkImage , coalesceEvents , contains , createImage , createImage , createVolatileImage , createVolatileImage , disableEvents , dispatchEvent , enable , enableEvents , enableInputMethods , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , getBackground , getBounds , getColorModel , getComponentListeners , getComponentOrientation , getCursor , getDropTarget , getFocusCycleRootAncestor , getFocusListeners , getFocusTraversalKeysEnabled , getFont , getForeground , getGraphicsConfiguration , getHierarchyBoundsListeners , getHierarchyListeners , getIgnoreRepaint , getInputContext , getInputMethodListeners , getInputMethodRequests , getKeyListeners , getLocale , getLocation , getLocationOnScreen , getMouseListeners , getMouseMotionListeners , getMousePosition , getMouseWheelListeners , getName , getParent , getPeer , getPropertyChangeListeners , getPropertyChangeListeners , getSize , getToolkit , getTreeLock , gotFocus , handleEvent , hasFocus , hide , imageUpdate , inside , isBackgroundSet , isCursorSet , isDisplayable , isEnabled , isFocusable , isFocusOwner , isFocusTraversable , isFontSet , isForegroundSet , isLightweight , isMaximumSizeSet , isMinimumSizeSet , isPreferredSizeSet , isShowing , isValid , isVisible , keyDown , keyUp , list , list , list , location , lostFocus , mouseDown , mouseDrag , mouseEnter , mouseExit , mouseMove , mouseUp , move , nextFocus , paintAll , postEvent , prepareImage , prepareImage , processComponentEvent , processFocusEvent , processHierarchyBoundsEvent , processHierarchyEvent , processInputMethodEvent , processMouseWheelEvent , remove , removeComponentListener , removeFocusListener , removeHierarchyBoundsListener , removeHierarchyListener , removeInputMethodListener , removeKeyListener , removeMouseListener , removeMouseMotionListener , removeMouseWheelListener , removePropertyChangeListener , removePropertyChangeListener , repaint , repaint , repaint , resize , resize , setBounds , setBounds , setComponentOrientation , setCursor , setDropTarget , setFocusable , setFocusTraversalKeysEnabled , setIgnoreRepaint , setLocale , setLocation , setLocation , setName , setSize , setSize , show , show , size , toString , transferFocus , transferFocusUpCycle

클래스 java.awt. Component 로부터 상속된 메소드

action , add , addComponentListener , addFocusListener , addHierarchyBoundsListener , addHierarchyListener , addInputMethodListener , addKeyListener , addMouseListener , addMouseMotionListener , addMouseWheelListener , bounds , checkImage , checkImage , coalesceEvents , contains , createImage , createImage , createVolatileImage , createVolatileImage , disableEvents , dispatchEvent , enable , enableEvents , enableInputMethods , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , getBackground , getBounds , getColorModel , getComponentListeners , getComponentOrientation , getCursor , getDropTarget , getFocusCycleRootAncestor , getFocusListeners , getFocusTraversalKeysEnabled , getFont , getForeground , getGraphicsConfiguration , getHierarchyBoundsListeners , getHierarchyListeners , getIgnoreRepaint , getInputContext , getInputMethodListeners , getInputMethodRequests , getKeyListeners , getLocale , getLocation , getLocationOnScreen , getMouseListeners , getMouseMotionListeners , getMousePosition , getMouseWheelListeners , getName , getParent , getPeer , getPropertyChangeListeners , getPropertyChangeListeners , getSize , getToolkit , getTreeLock , gotFocus , handleEvent , hasFocus , hide , imageUpdate , inside , isBackgroundSet , isCursorSet , isDisplayable , isEnabled , isFocusable , isFocusOwner , isFocusTraversable , isFontSet , isForegroundSet , isLightweight , isMaximumSizeSet , isMinimumSizeSet , isPreferredSizeSet , isShowing , isValid , isVisible , keyDown , keyUp , list , list , list , location , lostFocus , mouseDown , mouseDrag , mouseEnter , mouseExit , mouseMove , mouseUp , move , nextFocus , paintAll , postEvent , prepareImage , prepareImage , processComponentEvent , processFocusEvent , processHierarchyBoundsEvent , processHierarchyEvent , processInputMethodEvent , processMouseWheelEvent , remove , removeComponentListener , removeFocusListener , removeHierarchyBoundsListener , removeHierarchyListener , removeInputMethodListener , removeKeyListener , removeMouseListener , removeMouseMotionListener , removeMouseWheelListener , removePropertyChangeListener , removePropertyChangeListener , repaint , repaint , repaint , resize , resize , setBounds , setBounds , setComponentOrientation , setCursor , setDropTarget , setFocusable , setFocusTraversalKeysEnabled , setIgnoreRepaint , setLocale , setLocation , setLocation , setName , setSize , setSize , show , show , size , toString , transferFocus , transferFocusUpCycle

클래스 java.lang. Object 로부터 상속된 메소드
`clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait`

필드의 상세

orientation

protected int orientation

진척 바가 수평일까 수직인지를 나타냅니다. 디폴트는 HORIZONTAL 입니다.

관련 항목:: setOrientation(int)

paintBorder

protected boolean paintBorder

진척 바의 주위에 경계를 표시할지 어떨지를 나타냅니다. 디폴트는 true 입니다.

관련 항목:: setBorderPainted(boolean)

model

protected BoundedRangeModel  model

진척 바의 값을 보관 유지하는 객체입니다.

관련 항목:: setModel(javax.swing.BoundedRangeModel)

progressString

protected String  progressString

진척 바에 표시할 수 있는 임의 지정의 캐릭터 라인입니다. 디폴트는 null 입니다. null 이외의 값으로 설정해도, 반드시 캐릭터 라인이 표시되는 것은 아닙니다. 캐릭터 라인을 표시하는 경우는,paintString 를 true 로 해 주세요.

관련 항목:: setString(java.lang.String) , setStringPainted(boolean)

paintString

protected boolean paintString

진척 바에 캐릭터 라인을 표시할지 어떨지를 설정합니다. 디폴트는 false 입니다. true 로 설정하면(자), 진척 상황의 텍스트 표시가 진척 바에 draw 됩니다. progressString 이 null 의 경우, 완료한 비율이 진척 바에 표시됩니다. 그렇지 않은 경우는,progressString 이 진척 바에 draw 됩니다.

관련 항목:: setStringPainted(boolean) , setString(java.lang.String)

changeEvent

protected transient ChangeEvent  changeEvent

ChangeEvent 는, 인스턴스 마다 1 개(살)만 필요합니다. 이것은, 이 이벤트가 취급하는 프로퍼티의 소스가, 진척 바인 채 변함없기 때문입니다. 처음 이벤트 통지가 트리거되었을 때에, 이벤트는 늦어 작성됩니다.

관련 항목:: fireStateChanged()

changeListener

protected ChangeListener  changeListener

진척 바의 모델로부터 보내진 변경 이벤트를 대기해, 이 진척 바에 등록된 변경 이벤트 청취자에게 다시 발송 합니다.

관련 항목:: createChangeListener()

생성자 의 상세

JProgressBar

public JProgressBar()

경계를 표시해, 진척 캐릭터 라인을 표시하지 않는, 수평 방향의 진척 바를 작성합니다. 초기치 및 최소치는 0, 최대치는 100 입니다.

관련 항목:: setOrientation(int) , setBorderPainted(boolean) , setStringPainted(boolean) , setString(java.lang.String) , setIndeterminate(boolean)

JProgressBar

public JProgressBar(int orient)

지정한 방향 (SwingConstants.VERTICAL 또는 SwingConstants.HORIZONTAL)으로 진척 바를 작성합니다. 디폴트에서는, 경계는 페인트 되어 진척 캐릭터 라인은 페인트 되지 않습니다. 초기치 및 최소치는 0, 최대치는 100 입니다.

파라미터:: orient - 진척 바의 목적의 방향
예외:: IllegalArgumentException - orient 의 값이 무효인 경우
관련 항목:: setOrientation(int) , setBorderPainted(boolean) , setStringPainted(boolean) , setString(java.lang.String) , setIndeterminate(boolean)

JProgressBar

public JProgressBar(int min,
                    int max)

수평 방향의 진척 바를 작성합니다. 지정된 최소치 및 최대치를 사용합니다. 진척 바의 초기치를, 지정된 최소치로 설정합니다. 디폴트에서는, 경계는 페인트 되어 진척 캐릭터 라인은 페인트 되지 않습니다.

진척 바의 최소치, 초기치, 및 최대치로서 설정된 값이 적절하지 않기 위해(때문에) 문제가 발생했을 경우는, 진척 바의 데이터를 보관 유지하는 BoundedRangeModel 가 그 문제를 처리합니다. 자세한 것은,BoundedRangeModel 의 문서를 참조해 주세요.

파라미터:: min - 진척 바의 최소치; max - 진척 바의 최대치
관련 항목:: BoundedRangeModel , setOrientation(int) , setBorderPainted(boolean) , setStringPainted(boolean) , setString(java.lang.String) , setIndeterminate(boolean)

JProgressBar

public JProgressBar(int orient,
                    int min,
                    int max)

진척 바를 작성합니다. 지정된 방향, 최소치, 및 최대치를 사용합니다. 디폴트에서는, 경계는 페인트 되어 진척 캐릭터 라인은 페인트 되지 않습니다. 진척 바의 초기치를, 지정된 최소치로 설정합니다.

파라미터:: orient - 진척 바의 목적의 방향; min - 진척 바의 최소치; max - 진척 바의 최대치
예외:: IllegalArgumentException - orient 의 값이 무효인 경우
관련 항목:: BoundedRangeModel , setOrientation(int) , setBorderPainted(boolean) , setStringPainted(boolean) , setString(java.lang.String) , setIndeterminate(boolean)

JProgressBar

public JProgressBar(BoundedRangeModel  newModel)

수평 방향의 진척 바를 작성합니다. 진척 바의 데이터의 보관 유지에는 지정된 모델을 사용합니다. 디폴트에서는, 경계는 페인트 되어 진척 캐릭터 라인은 페인트 되지 않습니다.

파라미터:: newModel - 진척 바의 데이터 모델
관련 항목:: setOrientation(int) , setBorderPainted(boolean) , setStringPainted(boolean) , setString(java.lang.String) , setIndeterminate(boolean)

메소드의 상세

getOrientation

public int getOrientation()

진척 바의 방향으로 응해,SwingConstants.VERTICAL 나 SwingConstants.HORIZONTAL 를 돌려줍니다. 디폴트의 방향은 SwingConstants.HORIZONTAL 입니다.

반환값:: HORIZONTAL 또는 VERTICAL
관련 항목:: setOrientation(int)

setOrientation

public void setOrientation(int newOrientation)

진척 바의 방향을 newOrientation (SwingConstants.VERTICAL 또는 SwingConstants.HORIZONTAL)로 설정합니다. 디폴트의 방향은 SwingConstants.HORIZONTAL 입니다.

파라미터:: newOrientation - HORIZONTAL 또는 VERTICAL
예외:: IllegalArgumentException - newOrientation 가 부정한 값의 경우
관련 항목:: getOrientation()

isStringPainted

public boolean isStringPainted()

stringPainted 프로퍼티의 값을 돌려줍니다.

반환값:: stringPainted 프로퍼티의 값
관련 항목:: setStringPainted(boolean) , setString(java.lang.String)

setStringPainted

public void setStringPainted(boolean b)

stringPainted 프로퍼티의 값을 설정합니다. 이 프로퍼티은, 진척 바가 진척 캐릭터 라인을 draw 할지 어떨지를 지정합니다. 디폴트에서는 false 로 설정되어 캐릭터 라인은 페인트 되지 않습니다. 진척 캐릭터 라인을 지원하지 않는, 또는 진척 바가 불확정 모드 때만 지원하는 Look & Feel 도 있습니다.

파라미터:: b - 진척 바에 캐릭터 라인을 draw 하는 경우는 true
관련 항목:: isStringPainted() , setString(java.lang.String)

getString

public String  getString()

현재의 진척 상황을 나타내는 String 표현을 돌려줍니다. 디폴트에서는,getPercentComplete 의 반환값에 근거해, 단순한 퍼센티지를 나타내는 String 가 돌려주어집니다. 예를 들어, 「42%」과 같은 캐릭터 라인이 됩니다. 이 설정은,setString 를 호출하는 것으로 변경할 수 있습니다.

반환값:: 진척 캐릭터 라인의 값. 진척 캐릭터 라인이 null 의 경우, 단순한 퍼센티지를 나타내는 캐릭터 라인
관련 항목:: setString(java.lang.String)

setString

public void setString(String  s)

진척 캐릭터 라인의 값을 설정합니다. 디폴트에서는, 이 캐릭터 라인은 null 로, 단순한 퍼센티지를 나타내는 캐릭터 라인이 돌려주어집니다 (편입의 동작). 독자적인 진척 캐릭터 라인을 지정한 후에, 편입의 동작에 되돌리려면 , 캐릭터 라인을 null 로 다시 설정합니다.

진척 캐릭터 라인은,isStringPainted 가 true 를 돌려주는 경우에만 페인트 됩니다.

파라미터:: s - 진척 캐릭터 라인의 값
관련 항목:: getString() , setStringPainted(boolean) , isStringPainted()

getPercentComplete

public double getPercentComplete()

진척 바의 완료한 퍼센트를 돌려줍니다. 값은 0.0 ~ 1.0 의 범위인 것에 주의해 주세요.

반환값:: 진척 바의 완료한 퍼센트

isBorderPainted

public boolean isBorderPainted()

borderPainted 프로퍼티을 돌려줍니다.

반환값:: borderPainted 프로퍼티의 값
관련 항목:: setBorderPainted(boolean)

setBorderPainted

public void setBorderPainted(boolean b)

진척 바가 경계를 페인트 하도록(듯이) 하려면 true 로 할 필요가 있습니다. 이 프로퍼티의 디폴트 값는 true 입니다. 일부의 Look & Feel 에서는 경계의 페인트가 구현되어 있지 않을 가능성이 있습니다. 구현되어 있지 않은 경우, 이 프로퍼티은 무시됩니다.

파라미터:: b - 진척 바에 경계를 페인트 하는 경우는 true, 그렇지 않은 경우는 false
관련 항목:: isBorderPainted()

paintBorder

protected void paintBorder(Graphics  g)

borderPainted 프로퍼티이 true 인 경우에, 진척 바에 경계를 그립니다.

오버라이드(override):: 클래스 JComponent 내의 paintBorder

파라미터:: g - 경계를 페인트 하는 Graphics 문맥
관련 항목:: JComponent.paint(java.awt.Graphics) , JComponent.setBorder(javax.swing.border.Border) , isBorderPainted() , setBorderPainted(boolean)

getUI

public ProgressBarUI  getUI()

이 컴퍼넌트를 draw 하는 Look & Feel 객체를 돌려줍니다.

반환값:: 이 컴퍼넌트를 draw 하는 ProgressBarUI 객체

setUI

public void setUI(ProgressBarUI  ui)

이 컴퍼넌트를 draw 하는 Look & Feel 객체를 설정합니다.

파라미터:: ui - ProgressBarUI 객체
관련 항목:: UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

현재의 Look & Feel 로부터의 값에 UI 프로퍼티을 리셋 합니다.

오버라이드(override):: 클래스 JComponent 내의 updateUI

관련 항목:: JComponent.updateUI()

getUIClassID

public String  getUIClassID()

이 컴퍼넌트를 draw 하는 Look & Feel 클래스의 이름을 돌려줍니다.

오버라이드(override):: 클래스 JComponent 내의 getUIClassID

반환값:: 캐릭터 라인 「ProgressBarUI」
관련 항목:: JComponent.getUIClassID() , UIDefaults.getUI(javax.swing.JComponent)

createChangeListener

protected ChangeListener  createChangeListener()

서브 클래스가 다른 방법으로 변경 이벤트를 처리하는 경우는, 이 메소드를 오버라이드(override) 해 독자적인 ChangeListener 의 구현의 인스턴스를 돌려줄 수가 있습니다. 디폴트의 ChangeListener 은, 단순하게 fireStateChanged 메소드를 호출하는 것으로,ChangeEvent 를, 진척 바에 직접 추가된 ChangeListener 에 전송 합니다.

관련 항목:: changeListener , fireStateChanged() , ChangeListener , BoundedRangeModel

addChangeListener

public void addChangeListener(ChangeListener  l)

지정된 ChangeListener 를 진척 바에 추가합니다.

파라미터:: l - 추가하는 ChangeListener

removeChangeListener

public void removeChangeListener(ChangeListener  l)

진척 바로부터 ChangeListener 를 삭제합니다.

파라미터:: l - 삭제하는 ChangeListener

getChangeListeners

public ChangeListener [] getChangeListeners()

이 진척 바에 addChangeListener 로 추가된 모든 ChangeListener 의 배열을 돌려줍니다.

반환값:: 추가된 모든 ChangeListener. 청취자가 추가되어 있지 않은 경우는 빈 상태(empty)의 배열
도입된 버젼:: 1.4

fireStateChanged

protected void fireStateChanged()

이 JProgressBar 를 소스로 하는 ChangeEvent 를,ChangeEvent 의 통지를 받는 등록을 하고 있는 모든 ChangeListener 에 송신합니다. 이 메소드는, 모델로부터 ChangeEvent 를 수신할 때마다 불려 갑니다.

필요에 따라서 이벤트 인스턴스가 작성되어changeEvent 에 포함됩니다.

관련 항목:: addChangeListener(javax.swing.event.ChangeListener) , EventListenerList

getModel

public BoundedRangeModel  getModel()

이 진척 바가 사용하고 있는 데이터 모델을 돌려줍니다.

반환값:: 현재 사용하고 있는 BoundedRangeModel
관련 항목:: setModel(javax.swing.BoundedRangeModel) , BoundedRangeModel

setModel

public void setModel(BoundedRangeModel  newModel)

JProgressBar 가 사용하는 데이터 모델을 설정합니다. BoundedRangeModel 의 extent 는 사용하지 않기 때문에,0 으로 설정하는 것에 주의해 주세요.

파라미터:: newModel - 사용하는 BoundedRangeModel

getValue

public int getValue()

BoundedRangeModel 의 진척 바의 현재의 값 을 돌려줍니다. 이 값은 항상, 최소치 이상, 최대치 이하의 범위에 들어갑니다.

반환값:: 진척 바의 현재의 값
관련 항목:: setValue(int) , BoundedRangeModel.getValue()

getMinimum

public int getMinimum()

BoundedRangeModel 의 진척 바의 현재의 최소 치를 돌려줍니다.

반환값:: 진척 바의 최소치
관련 항목:: setMinimum(int) , BoundedRangeModel.getMinimum()

getMaximum

public int getMaximum()

BoundedRangeModel 의 진척 바의 현재의 최대 치를 돌려줍니다.

반환값:: 진척 바의 최대치
관련 항목:: setMaximum(int) , BoundedRangeModel.getMaximum()

setValue

public void setValue(int n)

진척 바의 현재의 값을 n 로 설정합니다. 이 메소드는 모델에 새로운 값을 전송 합니다.

올바르지 않은 값을 할당한 것에 의해 발생하는 수학적인 문제는, 데이터 모델 (BoundedRangeModel 인스턴스)이 처리합니다. 자세한 것은,BoundedRangeModel 의 문서를 참조해 주세요.

새로운 값이 이전의 값과 다른 경우는, 모든 변경 청취자가 통지됩니다.

파라미터:: n - 새로운 값
관련 항목:: getValue() , addChangeListener(javax.swing.event.ChangeListener) , BoundedRangeModel.setValue(int)

setMinimum

public void setMinimum(int n)

진척 바의 최소치 (진척 바의 데이터 모델에 포함)를 n 로 설정합니다.

최소치가 이전의 최소치와 다른 경우는, 모든 변경 청취자가 통지됩니다.

파라미터:: n - 새로운 최소치
관련 항목:: getMinimum() , addChangeListener(javax.swing.event.ChangeListener) , BoundedRangeModel.setMinimum(int)

setMaximum

public void setMaximum(int n)

진척 바의 최대치 (진척 바의 데이터 모델에 포함)를 n 로 설정합니다.

올바르지 않은 값을 할당한 것에 의해 발생하는 수학적인 문제는, 기본이 되는 BoundedRangeModel 가 처리합니다. 자세한 것은,BoundedRangeModel 의 문서를 참조해 주세요.

최대치가 이전의 최대치와 다른 경우는, 모든 변경 청취자가 통지됩니다.

파라미터:: n - 새로운 최대치
관련 항목:: getMaximum() , addChangeListener(javax.swing.event.ChangeListener) , BoundedRangeModel.setMaximum(int)

setIndeterminate

public void setIndeterminate(boolean newValue)

진척 바의 indeterminate 프로퍼티의 값을 설정합니다. 이 프로퍼티은, 진척 바가 확정 모드일까 불확정 모드인지를 지정합니다. 불확정 모드의 진척 바는 연속적으로 애니메이션을 표시해, 불명한 길이의 처리를 하고 있는 것을 나타냅니다. 디폴트에서는, 이 프로퍼티은 false 로 설정됩니다. 일부의 Look & Feel 에서는, 불확정 모드의 진척 바가 지원되어 있지 않을 가능성이 있습니다. 그 경우, 이 프로퍼티은 무시됩니다.

불확정 모드의 진척 바의 사용예에 대해서는,「How to Monitor Progress」를 참조해 주세요.

파라미터:: newValue - 진척 바를 불확정 모드로 전환하는 경우는 true, 일반적으로 모드에 되돌리는 경우는 false
도입된 버젼:: 1.4
관련 항목:: isIndeterminate() , BasicProgressBarUI

isIndeterminate

public boolean isIndeterminate()

indeterminate 프로퍼티의 값을 돌려줍니다.

반환값:: indeterminate 프로퍼티의 값
도입된 버젼:: 1.4
관련 항목:: setIndeterminate(boolean)

paramString

protected String  paramString()

이 JProgressBar 의 캐릭터 라인 표현을 돌려줍니다. 이 메소드는, 디버그 전용입니다. 반환되는 캐릭터 라인의 내용 및 형식은 구현에 따라서 다를 가능성이 있습니다. 반환되는 캐릭터 라인은 빈 상태(empty)의 경우가 있습니다만,null 로는 되지 않습니다.

오버라이드(override):: 클래스 JComponent 내의 paramString

반환값:: 이JProgressBar 의 캐릭터 라인 표현

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 JProgressBar 에 관련한 AccessibleContext 를 돌려줍니다. 진척 바의 경우,AccessibleContext 는 AccessibleJProgressBar 의 형식을 취합니다. 필요에 따라서 신규의 AccessibleJProgressBar 인스턴스가 작성됩니다.

정의:: 인터페이스 Accessible 내의 getAccessibleContext
오버라이드(override):: 클래스 JComponent 내의 getAccessibleContext

반환값:: 이 JProgressBar 의 AccessibleContext 로서 기능하는 AccessibleJProgressBar

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요 : 상자 | 필드 | 생성자 | 메소드

상세 : 필드 | 생성자 | 메소드

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

javax.swing 클래스 JProgressBar

orientation

paintBorder

model

progressString

paintString

changeEvent

changeListener

JProgressBar

JProgressBar

JProgressBar

JProgressBar

JProgressBar

getOrientation

setOrientation

isStringPainted

setStringPainted

getString

setString

getPercentComplete

isBorderPainted

setBorderPainted

paintBorder

getUI

setUI

updateUI

getUIClassID

createChangeListener

addChangeListener

removeChangeListener

getChangeListeners

fireStateChanged

getModel

setModel

getValue

getMinimum

getMaximum

setValue

setMinimum

setMaximum

setIndeterminate

isIndeterminate

paramString

getAccessibleContext

javax.swing
클래스 JProgressBar