메인 콘텐츠로 건너뛰기
이 객체는 메모리에 있는 리소스의 핸들에 접근할 수 있게 합니다. 비트맵 이미지나 메모리 블록에 접근하는 일부 메서드에서 반환됩니다. 이 객체는 이러한 리소스와 작업할 때 메모리 할당을 관리하며 메모리 누수를 방지할 수 있게 합니다.
이 인터페이스는 자동화를 지원하지 않습니다. 즉, FineReader Engine이 out-of-process 서버로 로드된 경우 Linux와 Windows에서 작동하지 않습니다.
이 객체는 다음 상황에서 사용됩니다:
  • FineReader Engine 외부에서 리소스와 작업할 계획인 경우
Handle 속성을 통해 리소스의 핸들을 가져와 작업할 수 있습니다. 이 경우 Handle 객체를 해제하면 리소스도 함께 해제됩니다. 또는 핸들을 가져온 후 Detach 메서드를 사용하여 Handle 객체를 핸들로부터 분리할 수 있습니다. 이 경우 리소스를 해제할 책임은 사용자에게 있습니다.
  • FineReader Engine의 다른 메서드로 리소스를 전달할 계획인 경우
HandleAsInt64 속성을 통해 리소스의 핸들을 __int64 형식으로 가져올 수 있습니다. 나중에 이 속성의 값을 필요로 하는 FineReader Engine의 메서드에 전달할 수 있습니다. Handle 객체를 해제하면 리소스도 함께 해제됩니다. CloseHandle 메서드를 호출하여 리소스를 수동으로 해제할 수도 있습니다.

속성

이름유형설명
Application엔진, 읽기 전용엔진 객체를 반환합니다.
HandleHANDLE*, 읽기 전용리소스의 핸들을 반환합니다. 이 속성을 통해 핸들을 얻을 수 있으며, 리소스와 작업할 수 있습니다.
HandleAsInt64__int64, 읽기 전용리소스의 핸들을 __int64로 반환합니다. 이 속성의 반환 값을 FineReader Engine의 메서드에 입력 매개변수로 전달할 수 있습니다.

메서드

이름설명
CloseHandle자원을 해제합니다.
Detach핸들을 반환하고 객체를 핸들로부터 분리합니다.

출력 매개변수

이 객체는 다음 메서드들의 출력 매개변수입니다:

샘플

FREngine.IEngine engine;
FREngine.IFRDocument frdoc;
// We presume that the document have been created and images have been added to it
// 문서가 생성되고 이미지들이 추가된 상태라고 가정합니다
// Get bitmap handle of a color image plane of a document page
// 문서 페이지의 컬러 이미지 평면 비트맵 핸들을 가져옵니다
FREngine.IFRPage page = frDoc.Pages[0];
FREngine.IImageDocument imageDoc = page.ImageDocument;
FREngine.IImage image = imageDoc.ColorImage;
FREngine.IHandle hBitmap = image.GetBitmap( null );
// Work with the bitmap
// 비트맵을 처리합니다
System.Drawing.IImage preprocessedImage = System.Drawing.Image.FromHbitmap( hBitmap.Handle );
...
Gdi32.DeleteObject( hBitmap );
이 객체는 다음 Windows 데모 도구에서 사용됩니다: 엔진 미리 정의된 처리 프로필.

참조

속성과 작업하기