javax.swing
클래스 ProgressMonitor

java.lang.Object 
  |
  +--javax.swing.ProgressMonitor

public class ProgressMonitor

extends Object

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

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

예 및 자세한 것은 「The Java Tutorial」의「How to Monitor Progress」를 참조해 주세요.

관련 항목:

ProgressMonitorInputStream

생성자의 개요

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

메소드의 개요

void	close () 처리가 완료한 것을 나타냅니다.
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

생성자의 상세

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 로 설정한 값이 >= max 의 경우에 자동적으로 발생합니다만, 처리가 빨리 종료했을 경우는 그것보다 빨리 불려 가는 일도 있습니다.

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)