TextBlock 객체 (ITextBlock 인터페이스)

이 객체는 텍스트 블록의 특정 속성에 액세스할 수 있게 해 줍니다. 이러한 블록은 서식 있는 텍스트로 인식된 이미지 영역에 해당합니다. 또한 이 객체를 통해 이 블록이 둘러싸는 이미지 부분에서 인식된 텍스트에도 액세스할 수 있습니다. ITextBlock 인터페이스는 IBlock 인터페이스에서 파생되며, 해당 인터페이스의 모든 속성을 상속합니다.

이 객체의 속성은 두 그룹으로 나눌 수 있습니다:

• 블록의 텍스트 인식 프로세스에 영향을 주는 속성입니다. 여기에는 ImageProcessingParams, AnalysisParams, RecognizerParams가 포함됩니다. 이러한 속성을 사용하면 개별 블록에 대한 특수 처리 매개변수를 설정할 수 있습니다.
• 분석 후 인식 전에 설정할 수도 있고, 인식 중에 프로그램이 채울 수도 있는 속성입니다. 여기에는 다양한 유형의 문서에서 블록의 역할을 지정하는 데 사용되는 BlockRole과 BusinessCardFieldType이 포함됩니다. TextOrientation 속성도 이 그룹에 속합니다.
• 인식 결과입니다. 이 그룹에는 블록의 인식된 텍스트를 나타내는 Text 속성만 포함됩니다.

​

속성

이름	유형	설명
처리 설정
AnalysisParams	TextBlockAnalysisParams	텍스트 블록의 분석 매개변수에 액세스합니다.
ImageProcessingParams	ImageProcessingParams	텍스트 블록의 이미지 전처리 매개변수에 액세스합니다.
RecognizerParams	RecognizerParams	텍스트 블록의 인식 매개변수에 액세스합니다.
텍스트의 역할 및 방향
BlockRole	BlockRoleEnum	문서의 논리 구조에서 텍스트 블록의 역할을 지정합니다. 기본값은 BR_Unknown입니다.
BusinessCardFieldType	BusinessCardFieldTypeEnum	명함의 일부인 텍스트 블록의 역할에 액세스합니다. IFRPage::SynthesizeBusinessCard 메서드가 호출되면 FineReader Engine은 명함에서 지정된 역할을 가진 블록을 해당 유형의 field로 간주합니다. 블록을 이 유형의 field로 간주할 수 없으면 해당 블록의 텍스트는 명함 텍스트에 표시되지 않습니다. 기본값은 BCFT_Unknown입니다.
TextOrientation	TextOrientation	블록 내 텍스트의 방향을 지정합니다. 인식 전에 이 값을 설정하면 블록의 텍스트가 해석되는 방식(예: 줄 단위 또는 열 단위)에 영향을 줍니다. 그렇지 않으면 인식 후 감지된 방향이 여기에 포함됩니다.
인식 결과
Text	Text, 읽기 전용	텍스트 블록에서 인식된 텍스트를 포함합니다.

​

메서드

이름	설명
CopyFrom	다른 객체의 해당 속성 값으로 현재 객체의 속성을 초기화합니다.

​

관련 객체

​

Windows

​

Linux 및 macOS

객체 다이어그램

​

출력 매개변수

이 객체는 블록 객체의 GetAsTextBlock 메서드의 출력 매개변수입니다.

​

예제

C# 코드

int totalCharsCount = 0;
FREngine.IBlock block;
// 텍스트의 문자 수를 계산합니다
if (block.Type == FREngine.BlockTypeEnum.BT_Text)
{
 FREngine.ITextBlock textBlock = block.GetAsTextBlock();
 int paragraphsCount = textBlock.Text.Paragraphs.Count;
 for (int iPar = 0; iPar < paragraphsCount; iPar++)
 {
  FREngine.IParagraph par = textBlock.Text.Paragraphs[iPar];
  string text = par.Text;
  totalCharsCount += text.Length;
 }
}

이 객체는 다음 코드 예제에서 사용됩니다:

• Linux: CustomLanguage
• Windows: CustomLanguage, RecognizedTextProcessing, 데모 도구: 엔진 미리 정의된 처리 프로필

​

참고 항목

블록

Layout 및 블록 다루기

속성 다루기