javax.swing
클래스 ProgressMonitor

java.lang.Object 
  javax.swing.ProgressMonitor

모든 구현된 인터페이스:

Accessible

public class ProgressMonitor
extends Object 
implements Accessible 

처리의 진척을 감시하는 클래스입니다. 처리로의해 장미구시간이 걸리는 경우에는 진척 다이얼로그가 표시됩니다. 작성된 ProgressMonitor 에는 수치 범위와 설명적인 캐릭터 라인이 주어집니다. 처리가 진행되면, setProgress 메서드를 호출해,[min, max] 범위에서 어느 정도 처리가 진행되고 있는지를 나타냅니다. 초기 상태에서는 ProgressDialog는 없습니다. 최초의 millisToDecideToPopup 밀리 세컨드 (디폴트는 500)가 경과하고 나서, 진척 모니터로 처리에 걸리는 시간이 예측됩니다. 그 시간이 millisToPopup (디폴트는 2000 밀리 세컨드, 즉 2 초)보다 긴 경우는 ProgressDialog가 표시됩니다.

다이알로그 박스가 가시인 경우는 setProgress가 불려 갔을 때에 진척 바가 갱신되는 일이 있습니다. setProgress는 항상 진척 바를 갱신하는 것은 아니고, 조작이 매우 진행되고 있는 경우에만 갱신합니다.

예 및자세한 내용은 「The Java Tutorial」의 「How to Monitor Progress」를 참조하십시오.

관련 항목:

ProgressMonitorInputStream

중첩(Nested) 클래스 개요

protected class

ProgressMonitor.AccessibleProgressMonitor AccessibleProgressMonitor는 ProgressMonitor 클래스의 액세스 가능성을 지원 합니다.

필드 개요

protected AccessibleContext

accessibleContext

생성자 개요

ProgressMonitor (Component parentComponent, Object message, String note, int min, int max)
진척 상황을 나타내는 그래픽 객체를 구축합니다.

메서드 개요

void	close () 처리가 완료한 것을 나타냅니다.
AccessibleContext	getAccessibleContext () ProgressMonitor AccessibleContext를 취득합니다.
int	getMaximum () 최대값 (진척치의 최고치)를 리턴합니다.
int	getMillisToDecideToPopup () 진척 모니터를 표시할지 어떨지를 결정하기까지 이 객체가 기다리는 시간을 리턴합니다.
int	getMillisToPopup () pop-up가 표시될 때까지의 시간을 리턴합니다.
int	getMinimum () 최소값 (진척치의 최저치)를 리턴합니다.
String	getNote () 진척 메세지와 함께 표시되는 추가의 주기를 리턴합니다.
boolean	isCanceled () 사용자가 진척 다이얼로그로 「취소 (Cancel)」버튼을 눌렀을 경우에 true를 리턴합니다.
void	setMaximum (int m) 최대값을 설정합니다.
void	setMillisToDecideToPopup (int millisToDecideToPopup) 진척 모니터를 표시할지 어떨지를 결정할 때까지의 대기 시간을 설정합니다.
void	setMillisToPopup (int millisToPopup) pop-up가 표시될 때까지의 시간을 설정합니다.
void	setMinimum (int m) 최소값을 설정합니다.
void	setNote (String note) 진척 메세지와 함께 표시되는 추가의 주기를 설정합니다.
void	setProgress (int nv) 감시하고 있는 처리의 진척 상황을 나타냅니다.

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

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

필드의 상세

accessibleContext

protected AccessibleContext  accessibleContext

생성자 상세

ProgressMonitor

public ProgressMonitor(Component  parentComponent,
                       Object  message,
                       String  note,
                       int min,
                       int max)

진척 상황을 나타내는 그래픽 객체를 구축합니다. 진척 상황은 보통, 처리가 완료에 가까워지는 것에 따라 구형의 바를 묻어 가는 것으로 가리킵니다.

파라미터:

parentComponent - 다이알로그 박스의 친컴퍼넌트

message - 감시하고 있는 처리를 사용자에 게 나타내기 위해서 표시되는 설명적인 메세지. 이것은 처리가 진행되어도 변경되지 않는다. 값의 범위에 대해서는 JOptionPane.message 메서드의 메세지 파라미터를 참조

note - 처리 상태를 설명하는 짧은 주. 처리가 진행되면, setNote를 호출해, 표시되고 있는 주를 변경할 수 있다. 예를 들어 파일의 리스트를 반복 처리 하는 조작으로 처리중의 파일명을 표시하는 경우 등에 이 주를 사용한다. 초기 상태로 note가 null인 경우, 다이알로그 박스에 주의 행은 없고, setNote는 무효인

min - 범위의 하한

max - 범위의 상한

관련 항목:

JDialog, JOptionPane

메서드의 상세

setProgress

public void setProgress(int nv)

감시하고 있는 처리의 진척 상황을 나타냅니다. 지정된 값이 최대값 이상의 경우, 진척 모니터는 닫습니다.

파라미터:

nv - 현재의 값을 나타내는 int값 . 이 컴퍼넌트로 지정된 최대값 와 최소값의 범위내

관련 항목:

setMinimum(int), setMaximum(int), close()

close

public void close()

처리가 완료한 것을 나타냅니다. 이것은 setProgress 로 설정된 값이 최대값 이상이 되면 자동적으로 발생합니다만, 처리가 빨리 종료했을 경우는 그것보다 빨리 호출되는 일도 있습니다.

getMinimum

public int getMinimum()

최소값 (진척치의 최저치)를 리턴합니다.

반환값:

최소값을 나타내는 int값

관련 항목:

setMinimum(int)

setMinimum

public void setMinimum(int m)

최소값을 설정합니다.

파라미터:

m - 최소값을 지정하는 int값

관련 항목:

getMinimum()

getMaximum

public int getMaximum()

최대값 (진척치의 최고치)를 리턴합니다.

반환값:

최대값을 나타내는 int값

관련 항목:

setMaximum(int)

setMaximum

public void setMaximum(int m)

최대값을 설정합니다.

파라미터:

m - 최대값을 지정하는 int값

관련 항목:

getMaximum()

isCanceled

public boolean isCanceled()

사용자가 진척 다이얼로그로 「취소 (Cancel)」버튼을 눌렀을 경우에 true를 리턴합니다.

setMillisToDecideToPopup

public void setMillisToDecideToPopup(int millisToDecideToPopup)

진척 모니터를 표시할지 어떨지를 결정할 때까지의 대기 시간을 설정합니다.

파라미터:

millisToDecideToPopup - 대기 시간을 지정하는 int값 (밀리 세컨드 단위)

관련 항목:

getMillisToDecideToPopup()

getMillisToDecideToPopup

public int getMillisToDecideToPopup()

진척 모니터를 표시할지 어떨지를 결정하기까지 이 객체가 기다리는 시간을 리턴합니다.

관련 항목:

setMillisToDecideToPopup(int)

setMillisToPopup

public void setMillisToPopup(int millisToPopup)

pop-up가 표시될 때까지의 시간을 설정합니다. 예상 남은 시간이 이 시간보다 짧은 경우, pop-up는 표시되지 않습니다.

파라미터:

millisToPopup - 시간을 지정하는 int값 (밀리 세컨드 단위)

관련 항목:

getMillisToPopup()

getMillisToPopup

public int getMillisToPopup()

pop-up가 표시될 때까지의 시간을 리턴합니다.

관련 항목:

setMillisToPopup(int)

setNote

public void setNote(String  note)

진척 메세지와 함께 표시되는 추가의 주기를 설정합니다. 예를 들어 복수의 파일을 카피하고 있을 때 현재 어느 파일이 카피되고 있는지를 나타내기 위해서 사용됩니다.

파라미터:

note - 표시하는 주기를 지정하는 String

관련 항목:

getNote()

getNote

public String  getNote()

진척 메세지와 함께 표시되는 추가의 주기를 리턴합니다.

반환값:

표시하는 주기를 지정하는 String

관련 항목:

setNote(java.lang.String)

getAccessibleContext

public AccessibleContext  getAccessibleContext()

ProgressMonitor AccessibleContext를 취득합니다.

정의:

인터페이스 Accessible 내의 getAccessibleContext

반환값:

ProgressMonitor AccessibleContext

도입된 버전 :

1.5