JavaTM Platform
Standard Ed. 6

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

상자의 클래스의 개요
protected  class ProgressMonitor.AccessibleProgressMonitor
          AccessibleProgressMonitorProgressMonitor 클래스용의 접근성? 지원를 구현하고 있습니다.
 
필드의 개요
protected  AccessibleContext accessibleContext
          ProgressMonitorAccessibleContext 입니다.
 
생성자 의 개요
ProgressMonitor (Component  parentComponent, Object  message, String  note, int min, int max)
          진척 상황을 나타내는 그래픽 객체를 구축합니다.
 
메소드의 개요
 void close ()
          처리가 완료한 것을 나타냅니다.
 AccessibleContext getAccessibleContext ()
          ProgressMonitorAccessibleContext 를 가져옵니다.
 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
ProgressMonitorAccessibleContext 입니다.

도입된 버젼:
1.5
생성자 의 상세

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()
ProgressMonitorAccessibleContext 를 가져옵니다.

정의:
인터페이스 Accessible 내의 getAccessibleContext
반환값:
ProgressMonitorAccessibleContext
도입된 버젼:
1.5

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.