메인 콘텐츠로 건너뛰기
이 메서드는 클라이언트 측에서 구현됩니다. Document Viewer에서 활성 페이지를 변경하기 전에 ABBYY FineReader Engine이 이 메서드를 호출합니다. 페이지가 Document Viewer의 그래픽 사용자 인터페이스 또는 동기화된 구성 요소를 통해 변경되면 이 프로세스가 호출됩니다. 활성 페이지가 Document Viewer의 API를 통해 변경되거나 활성 페이지가 삭제된 경우에는 이 프로세스가 호출되지 않습니다. 이 메서드는 새 활성 페이지에 대한 참조를 클라이언트에 전달합니다. 이 메서드를 사용하여 작업을 취소할 수 있습니다.

구문

C++

HRESULT OnActivePageChanging(
  IFRPage*      Page,
  VARIANT_BOOL* Cancel
);

C#

void OnActivePageChanging(
  IFRPage   Page,
  out bool Cancel
);

Visual Basic .NET

Sub OnActivePageChanging( _
  Page As IFRPage, _
  ByRef Cancel As Boolean _
)

매개변수

페이지 [in] 새 활성 페이지가 들어 있는 FRPage 객체를 가리킵니다. 이 매개변수는 NULL일 수 있으며, 이는 문서에 활성 페이지가 없음을 의미합니다(예: 모든 페이지가 삭제된 경우). Cancel [out] 프로세스를 중단해야 함을 나타내려면 이 변수를 TRUE로 설정할 수 있습니다. 이 경우 활성 페이지는 변경되지 않습니다.

반환 값

[C++ 전용] 이 메서드가 S_OK 이외의 값을 반환하면 클라이언트 측에서 오류가 발생한 것이며, 이 경우 Cancel 매개변수 값은 고려되지 않습니다.

비고

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

참고 항목

IDocumentViewerEvents