IImageViewerEvents 인터페이스의 OnToolAddBlock 메서드

이 메서드는 클라이언트 측에 구현됩니다. Image Viewer의 다음 도구 중 하나를 사용하여 그린 새 블록을 추가하기 전에 ABBYY FineReader Engine이 이 메서드를 호출합니다.

• 인식 영역 그리기 (MI_ChooseTool_DrawRecognitionArea)
• 텍스트 영역 그리기 (MI_ChooseTool_DrawTextBlock)
• 표 영역 그리기 (MI_ChooseTool_DrawTableBlock)
• 그림 영역 그리기 (MI_ChooseTool_DrawPictureBlock)
• 배경 그림 영역 그리기 (MI_ChooseTool_DrawBackgroundPictureBlock)
• Barcode 영역 그리기 (MI_ChooseTool_DrawBarcodeBlock)

이러한 도구를 선택하는 방법은 Image Viewer Commands의 설명을 참조하세요.

이 메서드는 그려진 블록의 유형과 영역 등 블록에 대한 정보를 클라이언트에 전달합니다. 또한 이 메서드를 사용하여 작업을 취소할 수 있습니다.

​

구문

​

C++

HRESULT OnToolAddBlock(
  BlockTypeEnum type,
  IFRRectangle* BlockRect,
  VARIANT_BOOL* Cancel
);

​

C#

void OnToolAddBlock(
  BlockTypeEnum type,
  IFRRectangle   BlockRect,
  out bool      Cancel
);

​

Visual Basic .NET

Sub OnToolAddBlock( _
  type As BlockTypeEnum, _
  BlockRect As IFRRectangle, _
  ByRef Cancel As Boolean _
)

​

매개변수

type

[in] 블록의 유형을 나타냅니다. BlockTypeEnum 상수 설명을 참조하세요.

BlockRect

[in] 블록의 좌표를 나타냅니다. 좌표는 FRRectangle 객체로 표현됩니다. 좌표는 문서 이미지 기준의 픽셀 단위로 지정됩니다.

Cancel

[out] 처리를 중단해야 함을 나타내려면 이 변수를 TRUE로 설정할 수 있습니다. 이 경우 블록은 생성되지 않습니다.

​

반환 값

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

​

비고

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

​

참고 항목

IImageViewerEvents