javax.swing.plaf.basic
클래스 BasicProgressBarUI

java.lang.Object 
  javax.swing.plaf.ComponentUI 
      javax.swing.plaf.ProgressBarUI 
          javax.swing.plaf.basic.BasicProgressBarUI

알려진 직계 서브 클래스:

MetalProgressBarUI

public class BasicProgressBarUI
extends ProgressBarUI 

ProgressBarUI 기본 Look & Feel 에 한 구현입니다.

중첩(Nested) 클래스 개요

class

BasicProgressBarUI.ChangeHandler 이 내부 클래스는 "public"와 마크 됩니다만, 이것은 컴파일러의 버그가 원인입니다.

필드 개요

protected Rectangle	boxRect 페인트 되는 (getBox에 의해 리턴된) 바운싱복스의 위치와 사이즈를 보관 유지하기 위해서 사용합니다.
protected ChangeListener	changeListener
protected JProgressBar	progressBar

생성자 개요

BasicProgressBarUI ()

메서드 개요

static ComponentUI	createUI (JComponent x)
protected int	getAmountFull (Insets b, int width, int height) 모델로부터 모은 완료 퍼센트 정보에 기반해 전부 칠해지는 진척 바의 양을 결정합니다.
protected int	getAnimationIndex () 현재의 애니메이션 프레임의 인덱스를 취득합니다.
protected Rectangle	getBox (Rectangle r) 현재의 애니메이션 인덱스를 위해서 r로 페인트 되어r를 돌려주는 바운싱복스의 위치와 사이즈를 포함합니다.
protected int	getBoxLength (int availableLength, int otherDimension) 페인트 되는 「바운싱복스」의 길이를 리턴합니다.
protected int	getCellLength () 진척 바에 렌더링 되는 개개의 셀 및 단위의넓이 (HORIZONTAL인 경우) 또는 높이 (VERTICAL인 경우)를 리턴합니다.
protected int	getCellSpacing () 진척 바에 있는 각 셀 및 단위의 간격을 리턴합니다.
Dimension	getMaximumSize (JComponent c) Look & Feel에 적절한, 지정된 컴퍼넌트의 최대 사이즈를 리턴합니다.
Dimension	getMinimumSize (JComponent c) 이 컴퍼넌트에서의 최소 사이즈는 10 입니다.
protected Dimension	getPreferredInnerHorizontal ()
protected Dimension	getPreferredInnerVertical ()
Dimension	getPreferredSize (JComponent c) Look & Feel에 적절한, 지정된 컴퍼넌트의 적절한 사이즈를 리턴합니다.
protected Color	getSelectionBackground () selectionBackground는 진척 바가 전부 칠해지지 않은 영역에 렌더링 할 때의 텍스트의 색입니다.
protected Color	getSelectionForeground () selectionForeground는 진척 바가 전부 칠해진 영역에 렌더링 할 때의 텍스트의 색입니다.
protected Point	getStringPlacement (Graphics g, String progressString, int x, int y, int width, int height) 진척 캐릭터 라인의 페인트 위치를 지정합니다.
protected void	incrementAnimationIndex () 현재의 애니메이션 프레임의 인덱스를, 다음의 유효치로 설정해, 진척 바가 페인트 다시 하도록 합니다.
protected void	installDefaults ()
protected void	installListeners ()
void	installUI (JComponent c) Look & Feel에 적절한, 지정된 컴퍼넌트를 구성합니다.
void	paint (Graphics g, JComponent c) 페인트를 2개의 메서드 paintDeterminate 또는 paintIndeterminate 어딘가에 위양 합니다.
protected void	paintDeterminate (Graphics g, JComponent c) 거의 모든 직선 불확정 진척 바로 올바르게 동작하는 범용의 paint 메서드입니다.
protected void	paintIndeterminate (Graphics g, JComponent c) 모든 직선 바운싱복스 진척 바가 올바르게 동작하는 범용의 paint 메서드입니다.
protected void	paintString (Graphics g, int x, int y, int width, int height, int amountFull, Insets b)
protected void	setAnimationIndex (int newValue) 현재의 애니메이션 프레임의 인덱스를 특정의 값으로 설정해, 진척 바를 페인트 다시 하도록 요구합니다.
protected void	setCellLength (int cellLen)
protected void	setCellSpacing (int cellSpace)
protected void	startAnimationTimer () 애니메이션 thread를 시작해, 필요하면 작성해, 초기화합니다.
protected void	stopAnimationTimer () 애니메이션 thread를 정지합니다.
protected void	uninstallDefaults ()
protected void	uninstallListeners () 이 객체가 인스톨 한 모든 리스너를 삭제합니다.
void	uninstallUI (JComponent c) installUI 시에 지정된 컴퍼넌트로 실행한 구성을 취소합니다.

클래스 javax.swing.plaf. ComponentUI 로부터 상속된 메서드

contains, getAccessibleChild, getAccessibleChildrenCount, update

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

필드의 상세

progressBar

protected JProgressBar  progressBar

changeListener

protected ChangeListener  changeListener

boxRect

protected Rectangle  boxRect

페인트 되는 (getBox에 의해 리턴된) 바운싱복스의 위치와 사이즈를 보관 유지하기 위해서 사용합니다.

도입된 버전 :

1.5

생성자 상세

BasicProgressBarUI

public BasicProgressBarUI()

메서드의 상세

createUI

public static ComponentUI  createUI(JComponent  x)

installUI

public void installUI(JComponent  c)

클래스 ComponentUI 기술:

Look & Feel에 적절한, 지정된 컴퍼넌트를 구성합니다. 이 메서드는 ComponentUI인스턴스가 지정된 컴퍼넌트의 UI 위양으로서 인스톨 되고 있을 때 호출합니다. 이 메서드는 이하를 포함한 Look & Feel용의 컴퍼넌트를 완전하게 구성할 필요가 있습니다.

1. 컬러, 폰트, 보더,자식아이콘, 불투명함 등 모든 디폴트 프로퍼티의 값을 컴퍼넌트에 인스톨 한다. 가능한 경우는 클라이언트 프로그램에 의해 초기화된 프로퍼티의 값을 오버라이드(override) 해서는 안 된다
2. 필요에 따라서, 컴퍼넌트에 LayoutManager를 인스톨 한다
3. 필요한 서브 컴퍼넌트를, 컴퍼넌트에 작성 또는 추가한다
4. 이벤트 리스너를, 컴퍼넌트에 작성 또는 인스톨 한다
5. 컴퍼넌트의 프로퍼티의 변경을 적절히 검출해, 응답하기 위해서 PropertyChangeListener를 컴퍼넌트에 작성 또는 인스톨 한다
6. 키보드 UI (Mnemonics, traversal등)를, 컴퍼넌트에 인스톨 한다
7. 적절한 인스턴스의 데이터를 초기화한다

오버라이드(override):

클래스 ComponentUI 내의 installUI

파라미터:

c - UI 위양이 인스톨 되고 있는 컴퍼넌트

관련 항목:

ComponentUI.uninstallUI(javax.swing.JComponent), JComponent.setUI(javax.swing.plaf.ComponentUI), JComponent.updateUI()

uninstallUI

public void uninstallUI(JComponent  c)

클래스 ComponentUI 기술:

installUI 시에 지정된 컴퍼넌트로 실행한 구성을 취소합니다. 이 메서드는 지정된 컴퍼넌트의 UI 위양으로서의 UIComponent인스턴스가 삭제되고 있을 때 호출합니다. 이 메서드는 installUI에 의해 실행된 구성을 바탕으로 되돌릴 필요가 있습니다. 이 경우 JComponent인스턴스를 깨끗한 상태 (여분의 리스너나, Look & Feel 고유의 프로퍼티 객체가 남지 않게)로 하도록 충분히 주의해 주세요. 순서에는 다음의 것이 있습니다.

1. UI 로서 설정된 모든 보더를, 컴퍼넌트로부터 삭제한다
2. UI 로서 설정된 모든 레이아웃 매니저를, 컴퍼넌트로부터 삭제한다
3. UI 로서 추가된 모든 서브 컴퍼넌트를, 컴퍼넌트로부터 삭제한다
4. UI 로서 추가된 모든 이벤트/리스너를, 컴퍼넌트로부터 삭제한다
5. UI 로서 인스톨 된 모든 키보드 UI를, 컴퍼넌트로부터 삭제한다
6. GC 용으로 할당할 수 있던 모든 인스턴스의 데이터 객체를 무효로 한다

오버라이드(override):

클래스 ComponentUI 내의 uninstallUI

파라미터:

c - 이 UI 위양이 삭제되는 컴퍼넌트. 이 인수는 자주 무시되지만, UI 객체가 상태없이 복수의 컴퍼넌트에 공유되는 경우에 사용되는 일이 있는

관련 항목:

ComponentUI.installUI(javax.swing.JComponent), JComponent.updateUI()

installDefaults

protected void installDefaults()

uninstallDefaults

protected void uninstallDefaults()

installListeners

protected void installListeners()

startAnimationTimer

protected void startAnimationTimer()

애니메이션 thread를 시작해, 필요하면 작성해, 초기화합니다. 불확정인 진척 바가 애니메이션을 개시할 필요가 있는 경우에 이 메서드가 호출됩니다. 이것에는 다음과 같은 이유가 있습니다.

• 진척 바가 확정 모드로 표시 가능하게 되었다
• 진척 바가 표시 가능해, 확정 모드가 되었다
• 진척 바가 표시 가능해, 확정 모드이며, 이 UI가 인스톨 되고 있다

독자적인 애니메이션 thread를 구현하는 경우는 이 메서드를 오버라이드(override) 할 필요가 있습니다.

도입된 버전 :

1.4

관련 항목:

stopAnimationTimer()

stopAnimationTimer

protected void stopAnimationTimer()

애니메이션 thread를 정지합니다. 불확정인 애니메이션을 정지할 필요가 있는 경우에 이 메서드가 호출됩니다. 이것에는 다음과 같은 이유가 있습니다.

• 진척 바가 확정 모드로 바뀐다
• 진척 바가 표시 가능 계층에 포함되지 않게 되었다
• 이 UI가 언인스톨되었다

독자적인 애니메이션 thread를 구현하는 경우는 이 메서드를 오버라이드(override) 할 필요가 있습니다.

도입된 버전 :

1.4

관련 항목:

startAnimationTimer()

uninstallListeners

protected void uninstallListeners()

이 객체가 인스톨 한 모든 리스너를 삭제합니다.

getPreferredInnerHorizontal

protected Dimension  getPreferredInnerHorizontal()

getPreferredInnerVertical

protected Dimension  getPreferredInnerVertical()

getSelectionForeground

protected Color  getSelectionForeground()

selectionForeground는 진척 바가 전부 칠해진 영역에 렌더링 할 때의 텍스트의 색입니다.

getSelectionBackground

protected Color  getSelectionBackground()

selectionBackground는 진척 바가 전부 칠해지지 않은 영역에 렌더링 할 때의 텍스트의 색입니다.

getCellLength

protected int getCellLength()

진척 바에 렌더링 되는 개개의 셀 및 단위의넓이 (HORIZONTAL인 경우) 또는 높이 (VERTICAL인 경우)를 리턴합니다. 다만, 텍스트의 렌더링의 간략화 및 표시상의 아름다움의 관점으로부터, 진척 캐릭터 라인이 렌더링 되고 있는 동안은 이 함수는 1을 리턴합니다.

반환값:

셀의 간격을 나타내는 값

관련 항목:

setCellLength(int), JProgressBar.isStringPainted()

setCellLength

protected void setCellLength(int cellLen)

getCellSpacing

protected int getCellSpacing()

진척 바에 있는 각 셀 및 단위의 간격을 리턴합니다. 다만, 텍스트의 렌더링의 간략화 및 표시상의 아름다움의 관점으로부터, 진척 캐릭터 라인이 렌더링 되고 있는 동안은 이 함수는 0을 리턴합니다.

반환값:

셀의 간격을 나타내는 값

관련 항목:

setCellSpacing(int), JProgressBar.isStringPainted()

setCellSpacing

protected void setCellSpacing(int cellSpace)

getAmountFull

protected int getAmountFull(Insets  b,
                            int width,
                            int height)

모델로부터 모은 완료 퍼센트 정보에 기반해 전부 칠해지는 진척 바의 양을 결정합니다. 이것은 공용의 조작이므로 추상화 되고 있습니다. 여기에서는 사용하는 진척 바가 직선이라고 상정하고 있습니다. 즉, 원형의 진척 인디케이터(indicator)를 작성하는 경우는 이 메서드를 오버라이드(override) 할 수 있습니다.

paint

public void paint(Graphics  g,
                  JComponent  c)

페인트를 2개의 메서드 paintDeterminate 또는 paintIndeterminate 어딘가에 위양 합니다.

오버라이드(override):

클래스 ComponentUI 내의 paint

파라미터:

g - 페인트 대상의 Graphics 컨텍스트

c - 페인트 되는 컴퍼넌트. 이 인수는 자주 무시되지만, UI 객체가 상태없이 복수의 컴퍼넌트에 공유되는 경우에 사용되는 일이 있는

관련 항목:

ComponentUI.update(java.awt.Graphics, javax.swing.JComponent)

getBox

protected Rectangle  getBox(Rectangle  r)

현재의 애니메이션 인덱스를 위해서 r로 페인트 되어r를 돌려주는 바운싱복스의 위치와 사이즈를 포함합니다. paintIndeterminate 이 클래스에서의 구현으로 실행되는 페인트에 추가하는 서브 클래스는 예를 들어 바운싱복스의 주위에 아우트라인을 렌더링 하기 위해서 이 메서드를 사용해, 지금 페인트 된 바운싱복스의 위치를 취득할 수 있습니다. 이 메서드를 오버라이드(override) 하는 것으로써, paintIndeterminate를 다시 구현하는 필요없음에 바운싱복스의 사이즈와 위치를 완전하게 제어할 수 있습니다.

파라미터:

r - 변경되는 Rectangle 인스턴스. null인 경우도 있다

반환값:

박스를 렌더링 할 필요가 없는 경우는 null. 그렇지 않은 경우는 null이 아닐 때, 건네받은 구형, 또는 새로운 구형을 돌려주는

도입된 버전 :

1.4

관련 항목:

setAnimationIndex(int)

getBoxLength

protected int getBoxLength(int availableLength,
                           int otherDimension)

페인트 되는 「바운싱복스」의 길이를 리턴합니다. 이 메서드는 박스의넓이 (진척 바가 수평 방향의 경우) 또는 높이 (진척 바가 수직 방향의 경우)를 취득하기 위해서 paintIndeterminate 디폴트의 구현에 의해 호출합니다. 예를 들어 다음과 같이 됩니다.

boxRect.width = getBoxLength(componentInnards.width,
                             componentInnards.height);
 

파라미터:

availableLength - 이동하는 바운싱복스에 이용할 수 있는 스페이스의 양. 예를 들어 수평 방향의 진척 바에서는 진척 바의 내부의넓이 (컴퍼넌트폭으로부터 보더를 뺀 값)이 되는

otherDimension - 수평 방향의 진척 바에서는 진척 바의 내부의 높이가 된다. 이 값은 반환값을 제한하거나 결정하거나 하기 위해서 사용할 수 있다

반환값:

결정되는 박스의 사이즈. availableLength 이하가 될 필요가 있는

도입된 버전 :

1.5

관련 항목:

SwingUtilities.calculateInnerArea(javax.swing.JComponent, java.awt.Rectangle)

paintIndeterminate

protected void paintIndeterminate(Graphics  g,
                                  JComponent  c)

모든 직선 바운싱복스 진척 바가 올바르게 동작하는 범용의 paint 메서드입니다. 다른 종류의 진척 바를 작성한 경우는 이 메서드를 오버라이드(override)의해 주세요.

도입된 버전 :

1.4

관련 항목:

paintDeterminate(java.awt.Graphics, javax.swing.JComponent)

paintDeterminate

protected void paintDeterminate(Graphics  g,
                                JComponent  c)

거의 모든 직선 불확정 진척 바로 올바르게 동작하는 범용의 paint 메서드입니다. 디폴트의 테이블에 값을 설정하는 것만으로 진척 바의 페인트가 문제 없게 동작하게 됩니다. 원형, 혹은 반원형의 진척 바를 작성하는 경우에는 이 메서드를 오버라이드(override)의해 주세요.

도입된 버전 :

1.4

관련 항목:

paintIndeterminate(java.awt.Graphics, javax.swing.JComponent)

paintString

protected void paintString(Graphics  g,
                           int x,
                           int y,
                           int width,
                           int height,
                           int amountFull,
                           Insets  b)

getStringPlacement

protected Point  getStringPlacement(Graphics  g,
                                   String  progressString,
                                   int x,
                                   int y,
                                   int width,
                                   int height)

진척 캐릭터 라인의 페인트 위치를 지정합니다. 이 구현에서는 진척 바의 중앙 (x 및 y 양쪽 모두)에 캐릭터 라인을 배치합니다. 진척 캐릭터 라인을 우, 좌, 상, 혹은 아래에 배치하는 경우, 혹은 하등의 이유로써 삭제하는 경우는 이 메서드를 오버라이드(override)의해 주세요.

getPreferredSize

public Dimension  getPreferredSize(JComponent  c)

클래스 ComponentUI 기술:

Look & Feel에 적절한, 지정된 컴퍼넌트의 적절한 사이즈를 리턴합니다. null이 리턴된인 경우, 적절한 사이즈는 대신에 컴퍼넌트의 레이아웃 매니저에 의해 계산됩니다 (이것은 특정의 레이아웃 매니저를 인스톨 되어 있는 컴퍼넌트의 경우에 추천 하는 방법입니다). 이 메서드의 디폴트 구현은 null을 리턴합니다.

오버라이드(override):

클래스 ComponentUI 내의 getPreferredSize

파라미터:

c - 적절한 사이즈가 조회되는 컴퍼넌트. 이 인수는 자주 무시되지만, UI 객체가 상태없이 복수의 컴퍼넌트에 공유되는 경우에 사용되는 일이 있는

관련 항목:

JComponent.getPreferredSize(), LayoutManager.preferredLayoutSize(java.awt.Container)

getMinimumSize

public Dimension  getMinimumSize(JComponent  c)

이 컴퍼넌트에서의 최소 사이즈는 10 입니다. 10 퍼센트에 대해서 1 픽셀 이상을 대응시키도록 할 필요가 있습니다.

오버라이드(override):

클래스 ComponentUI 내의 getMinimumSize

파라미터:

c - 최소 사이즈가 조회되는 컴퍼넌트. 이 인수는 자주 무시되지만, UI 객체가 상태없이 복수의 컴퍼넌트에 공유되는 경우에 사용되는 일이 있다

반환값:

Dimension 객체, 또는 null

관련 항목:

JComponent.getMinimumSize(), LayoutManager.minimumLayoutSize(java.awt.Container), ComponentUI.getPreferredSize(javax.swing.JComponent)

getMaximumSize

public Dimension  getMaximumSize(JComponent  c)

클래스 ComponentUI 기술:

Look & Feel에 적절한, 지정된 컴퍼넌트의 최대 사이즈를 리턴합니다. null이 리턴된인 경우, 최대 사이즈는 대신에 컴퍼넌트의 레이아웃 매니저에 의해 계산됩니다 (이것은 특정의 레이아웃 매니저를 인스톨 되어 있는 컴퍼넌트의 경우에 추천 하는 방법입니다). 이 메서드의 디폴트 구현은 getPreferredSize를 호출해, 그 값을 리턴합니다.

오버라이드(override):

클래스 ComponentUI 내의 getMaximumSize

파라미터:

c - 최대 사이즈가 조회되는 컴퍼넌트. 이 인수는 자주 무시되지만, UI 객체가 상태없이 복수의 컴퍼넌트에 공유되는 경우에 사용되는 일이 있다

반환값:

Dimension 객체, 또는 null

관련 항목:

JComponent.getMaximumSize(), LayoutManager2.maximumLayoutSize(java.awt.Container)

getAnimationIndex

protected int getAnimationIndex()

현재의 애니메이션 프레임의 인덱스를 취득합니다.

도입된 버전 :

1.4

setAnimationIndex

protected void setAnimationIndex(int newValue)

현재의 애니메이션 프레임의 인덱스를 특정의 값으로 설정해, 진척 바를 페인트 다시 하도록 요구합니다. 디폴트의 페인트 코드를 사용하지 않는 서브 클래스는 이 메서드를 오버라이드(override) 해, repaint 메서드의 시작 방법을 변경할 필요가 있습니다.

파라미터:

newValue - 새로운 애니메이션 인덱스. 값의 체크는 실행되지 않는

도입된 버전 :

1.4

관련 항목:

incrementAnimationIndex()

incrementAnimationIndex

protected void incrementAnimationIndex()

현재의 애니메이션 프레임의 인덱스를, 다음의 유효치로 설정해, 진척 바가 페인트 다시 하도록 합니다. 다음의 유효치는 디폴트에서는 현재의 애니메이션 인덱스에 1을 더한 것입니다. 새로운의 값이 너무 큰 경우, 이 메서드는 인덱스 0을 설정합니다. 서브 클래스는 이 메서드를 오버라이드(override) 해, 인덱스가 특정의 진척 바 인스턴스에 필요한 프레임수를 넘지 않게 할 필요가 있습니다. 이 메서드는 X 밀리 세컨드 마다, 디폴트의 애니메이션 thread에 의해 시작됩니다. 여기서, X는 ProgressBar.repaintInterval 로 지정됩니다.

도입된 버전 :

1.4

관련 항목:

setAnimationIndex(int)