ProgressMonitor
ProgressMonitor (진행 모니터)
어떤 작업의 진행 상황을 모니터링하는 클래스입니다. 작업이 오래 걸릴 것으로 보이면 진행 다이얼로그가 팝업됩니다.
본문
ProgressMonitor를 만들 때 숫자 범위와 설명 문자열을 지정합니다. 작업이 진행됨에 따라 setProgress 메서드를 호출하여 [min,max] 범위에서 작업이 얼마나 진행되었는지 알려줍니다.
처음에는 진행 다이얼로그가 없습니다. millisToDecideToPopup 밀리초(기본 500)가 지나면 진행 모니터가 작업이 얼마나 걸릴지 예측합니다. 그것이 millisToPopup(기본 2000, 즉 2초)보다 길면 진행 다이얼로그가 팝업됩니다.
다이얼로그가 보일 때 setProgress가 호출되면 진행 표시줄이 갱신됩니다. 다만 setProgress가 항상 진행 표시줄을 갱신하는 것은 아니며, 진행 양이 눈에 띄게 변할 때만 갱신합니다.
ProgressMonitorInputStream과 함께 입력 스트림의 진행 상황을 모니터링하는 데 쓰입니다. Since: 1.2
주요 메서드·상세 (Methods & details)
주요 메서드로 진행도를 갱신하는 setProgress(int), 작업 설명 문자열을 바꾸는 setNote(String), 사용자가 취소했는지 확인하는 isCanceled(), 최소·최대값을 얻거나 설정하는 getMinimum()/setMinimum(int)/getMaximum()/setMaximum(int) 등이 있습니다. 다이얼로그 문맥 정보는 setMillisToDecideToPopup(int)와 setMillisToPopup(int)로 조정합니다.