JProgressBar — 진행률 표시줄 컴포넌트
JProgressBar — 진행률 표시줄 컴포넌트
JProgressBar는 어떤 작업의 진행 상황을 시각적으로 표시하는 컴포넌트입니다. 작업이 완료를 향해 진행됨에 따라 완료 백분율을 표시합니다.
본문
public class JProgressBar extends JComponent implements SwingConstants, Accessible
어떤 작업의 진행 상황을 시각적으로 표시하는 컴포넌트입니다. 작업이 완료를 향해 진행됨에 따라 진행률 표시줄은 작업의 완료 백분율을 표시합니다. 이 백분율은 보통 처음에는 비어 있다가 작업이 진행됨에 따라 점차 채워지는 사각형으로 시각적으로 표시됩니다. 또한 진행률 표시줄은 이 백분율의 텍스트 표현을 표시할 수 있습니다. JProgressBar는 데이터 모델로 BoundedRangeModel을 사용하며, value 프로퍼티가 작업의 "현재" 상태를, minimum과 maximum 프로퍼티가 각각 시작점과 끝점을 나타냅니다. 길이를 알 수 없는 작업이 실행 중임을 나타내려면 진행률 표시줄을 불확정(indeterminate) 모드로 둘 수 있습니다. 막대가 불확정 모드인 동안에는 작업이 진행 중임을 보여주도록 계속 애니메이션합니다. 작업의 길이와 진행 정도를 결정할 수 있게 되면 진행률 표시줄의 값을 갱신하고 결정 모드로 다시 전환하세요. 예:
progressBar = new JProgressBar(0, task.getLengthOfTask());
progressBar.setValue(0);
progressBar.setStringPainted(true);
불확정 모드로 넣었다가 작업 길이를 알면 결정 모드로 다시 전환하는 예:
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은 스레드에 안전하지 않습니다. 이 클래스의 직렬화된 객체는 향후 Swing 버전과 호환되지 않을 수 있습니다. 현재 직렬화 지원은 단기 저장이나 같은 버전의 Swing을 실행하는 애플리케이션 간 RMI에 적합합니다. 1.4부터 모든 JavaBean의 장기 저장 지원이 java.beans 패키지에 추가되었으니 XMLEncoder를 참고하세요.
orientation
protected int orientation
진행률 표시줄이 수평인지 수직인지 여부입니다. 기본값은 HORIZONTAL입니다.
paintBorder
protected boolean paintBorder
진행률 표시줄이 테두리를 그릴지 여부입니다.
JProgressBar
public JProgressBar()
수평 진행률 표시줄을 만듭니다.
JProgressBar
public JProgressBar(int orient)
지정된 방향의 진행률 표시줄을 만듭니다.
- 매개변수:
orient-SwingConstants.HORIZONTAL또는SwingConstants.VERTICAL
JProgressBar
public JProgressBar(int min, int max)
지정된 최소·최대 값으로 수평 진행률 표시줄을 만듭니다.
- 매개변수:
min- 진행률 표시줄의 최소 값 - 매개변수:
max- 진행률 표시줄의 최대 값
JProgressBar
public JProgressBar(int orient, int min, int max)
지정된 방향, 최소·최대 값으로 진행률 표시줄을 만듭니다.
- 매개변수:
orient-SwingConstants.HORIZONTAL또는SwingConstants.VERTICAL - 매개변수:
min- 진행률 표시줄의 최소 값 - 매개변수:
max- 진행률 표시줄의 최대 값
JProgressBar
public JProgressBar(BoundedRangeModel model)
지정된 모델로 수평 진행률 표시줄을 만듭니다.
- 매개변수:
model- 사용할 BoundedRangeModel
setValue
public void setValue(int n)
진행률 표시줄의 현재 값을 n으로 설정합니다.
- 매개변수:
n- 새 값
getValue
public int getValue()
진행률 표시줄의 현재 값을 반환합니다.
- 반환값: 현재 값
setMinimum
public void setMinimum(int n)
모델의 최소 값을 설정합니다.
- 매개변수:
n- 새 최소 값
getMinimum
public int getMinimum()
모델의 최소 값을 반환합니다.
- 반환값: 최소 값
setMaximum
public void setMaximum(int n)
모델의 최대 값을 설정합니다.
- 매개변수:
n- 새 최대 값
getMaximum
public int getMaximum()
모델의 최대 값을 반환합니다.
- 반환값: 최대 값
setIndeterminate
public void setIndeterminate(boolean newValue)
진행률 표시줄을 결정 또는 불확정 모드로 설정합니다.
- 매개변수:
newValue- 불확정 모드로 만들려면 true
isIndeterminate
public boolean isIndeterminate()
진행률 표시줄이 불확정 모드인지 여부를 반환합니다.
- 반환값: 불확정 모드이면 true
setOrientation
public void setOrientation(int newOrientation)
진행률 표시줄의 방향을 설정합니다.
- 매개변수:
newOrientation-SwingConstants.HORIZONTAL또는SwingConstants.VERTICAL
getOrientation
public int getOrientation()
진행률 표시줄의 방향을 반환합니다.
- 반환값: 진행률 표시줄의 방향
setString
public void setString(String s)
진행률 표시줄에 표시할 문자열을 설정합니다.
- 매개변수:
s- 표시할 문자열
getString
public String getString()
진행률 표시줄의 현재 문자열을 반환합니다.
- 반환값: 현재 문자열
setStringPainted
public void setStringPainted(boolean b)
진행률 표시줄이 진행 문자열을 그릴지 여부를 설정합니다.
- 매개변수:
b- 문자열을 그리려면 true
isStringPainted
public boolean isStringPainted()
진행률 표시줄이 진행 문자열을 그리는지 여부를 반환합니다.
- 반환값: 문자열이 그려지면 true
setBorderPainted
public void setBorderPainted(boolean b)
진행률 표시줄이 테두리를 그릴지 여부를 설정합니다.
- 매개변수:
b- 테두리를 그리려면 true
isBorderPainted
public boolean isBorderPainted()
진행률 표시줄이 테두리를 그리는지 여부를 반환합니다.
- 반환값: 테두리가 그려지면 true