메인 콘텐츠로 건너뛰기
이 객체는 인식된 텍스트를 나타냅니다. 인식된 텍스트는 문단의 모음으로 구성됩니다. 이 모음은 Paragraphs 속성을 통해 액세스할 수 있습니다. 또한 이 객체는 다양한 텍스트 속성에 액세스하기 위한 속성과 세로/가로 분할, 범위 제거 등의 작업을 수행할 수 있는 메서드를 제공합니다. Text 객체는 독립적으로 존재할 수도 있고, 레이아웃의 한 단위(텍스트 블록, 표 셀 등)를 나타내는 다른 객체의 하위 객체일 수도 있습니다. 텍스트에서의 위치는 “(문단;기호)” 형태의 “좌표 쌍”으로 정의됩니다. 또한 이른바 “특수 위치”도 있으며, 이 경우 paragraph=<문단 수>, symbol=0입니다.
이 객체는 텍스트가 포함된 인식 블록을 통해 사용할 수 있습니다. 또한 PlainText 객체를 통해 문서 또는 페이지의 전체 인식 텍스트에 특수한 “일반 텍스트” 형식으로도 액세스할 수 있습니다.

​
속성

,읽기 전용

Engine 객체를 반환합니다.

전체 텍스트의 색상이 반전되었는지 여부를 지정합니다. 인식된 텍스트가 반전 속성을 가진 블록 또는 표 셀에 속하는 경우 이 속성은 TRUE로 설정됩니다. 사용자 인터페이스에서 검은색 배경에 흰색 글꼴로 텍스트를 표시하는 데 활용할 수 있습니다.

이 속성은 Text 객체가ITextBlock::Text속성을 통해 수신된 경우에만 편집할 수 있습니다. 그렇지 않으면 해당 속성은 읽기 전용입니다.

,읽기 전용

Text 객체의 단락 컬렉션에 접근할 수 있습니다. 빈 객체를 포함한 모든 Text 객체에는 Paragraphs 유형의 유효한 하위 객체가 포함되어 있습니다. 이 객체는객체의 컬렉션이며 요소를 포함하지 않을 수도 있습니다. Paragraph 객체는 인식된 텍스트의 단락을 나타내며, 인식된 텍스트의 내용은 이 객체를 통해 가져올 수 있습니다.

텍스트의 방향을 저장합니다. 인식된 텍스트를 내보낼 때 ABBYY FineReader Engine 내부적으로 사용됩니다.

이 속성은 인식 후에만 유효하며, 이미 인식된 텍스트의 방향은 변경할 수 없습니다. 인식 전에 페이지 방향을 지정하려면 ImageProcessingParams 객체의속성을 사용하십시오. 특정 텍스트 블록의 텍스트 방향을 지정하려면 인식 전에속성을 설정하십시오.

이 속성의 값을 설정해야 하는 경우는 내보낸 파일에 표시될 추가 텍스트를 삽입하려는 경우뿐입니다. 해당 텍스트를 추가한 후 이 속성을 사용하여 방향을 지정하고, 문서를 내보내기 전에 합성을 수행하는 메서드를 호출하십시오.

참고:

  • 이 속성은 상수 객체를 반환합니다. 텍스트 방향을 변경하려면 먼저메서드를 사용하여 중간 TextOrientation 객체를 가져온 후 필요한 매개변수를 변경하고, 얻은 객체를 속성에 할당해야 합니다.
  • 이 속성은 Text 객체가속성을 통해 수신된 경우에만 편집할 수 있습니다. 그렇지 않으면 해당 속성은 읽기 전용입니다.
  • 속성이 RT_UnknownRotation이거나속성이 TRT_Unknown인 TextOrientation 객체는 이 속성에 할당할 수 없습니다.

​
메서드

이름설명
AppendEmptyParagraph현재 텍스트 끝에 빈 단락을 추가합니다.
GetRange텍스트 범위의 사본을 반환합니다.
Remove현재 텍스트에서 범위를 제거합니다.
RemoveAll현재 텍스트에서 모든 단락을 제거합니다.
Text 객체 다이어그램

​
입력 Parameter

이 객체는 Paragraph 객체의 InsertText 메서드에 대한 입력 Parameter입니다.

​
샘플

FREngine.IBlock block;
int suspiciousCharsCount = 0;
// 텍스트 블록의 단락을 순회하며 텍스트를 가져옵니다
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;
 // 텍스트를 사용해 작업 수행
}
이 객체는 다음 코드 샘플에서 사용됩니다.

​
참고 항목

Text 다루기 속성 다루기