메인 콘텐츠로 건너뛰기
이 메서드는 클라이언트 측에 구현됩니다. Document Viewer에서 활성 페이지를 분석하거나 인식하는 동안 ABBYY FineReader Engine이 이 메서드를 호출합니다. 이 프로세스는 다음 방법 중 하나로 시작할 수 있습니다. 이러한 명령을 호출하는 방법은 Document Viewer Commands 목록을 참조하세요. 이러한 명령을 호출하는 방법은 Image Viewer Commands 목록을 참조하세요. 이러한 명령을 호출하는 방법은 Zoom Viewer Commands 목록을 참조하세요.
  • FineReader Engine API 사용
이 메서드는 작업의 대략적인 진행률을 클라이언트에 전달합니다. 구현에 따라 진행 상태 표시기를 표시할 수 있습니다. 장시간 작업 중 애플리케이션이 응답하지 않는 것처럼 보이지 않도록 시스템 메시지를 처리하세요. 이는 사용자 인터페이스가 있는 애플리케이션에서 유용할 수 있습니다. 또한 이 메서드를 사용하면 작업을 취소할 수 있습니다.

​
구문

​
C++

HRESULT OnProgress(
  int           Percentage,
  VARIANT_BOOL* Cancel
);

​
C#

void OnProgress(
  int      Percentage,
  out bool Cancel
);

​
Visual Basic .NET

Sub OnProgress( _
  Percentage As Integer, _
  ByRef Cancel As Boolean _
)

​
매개변수

Percentage [in] 현재까지 완료된 작업의 비율을 나타냅니다. 값의 범위는 0부터 100까지입니다. Cancel [out] 프로세스를 중지해야 함을 나타내기 위해 이 변수를 TRUE로 설정할 수 있습니다. 이 경우 분석 또는 인식 프로세스가 중단됩니다.

​
반환 값

[C++ 전용] 이 메서드가 S_OK 이외의 값을 반환하면 클라이언트 측에서 오류가 발생했음을 의미하며, 이 경우 Cancel 매개변수 값은 무시됩니다.

​
참고 사항

이 메서드를 구현하는 클라이언트는 메서드 내부에서 발생하는 모든 예외를 반드시 포착해 처리하고, 어떤 예외도 메서드 외부로 전파되지 않도록 해야 합니다. 예외가 메서드 외부로 전파되면 예측할 수 없는 결과(예: 프로그램 종료)가 발생할 수 있습니다.

​
참고 항목

DocumentViewer IDocumentViewerEvents