Zum Hauptinhalt springen
Dieses Objekt bietet Zugriff auf bestimmte Eigenschaften eines Textblocks. Diese Blöcke entsprechen einem Bildbereich, der als formatierter Text erkannt wurde. Über dieses Objekt kann auch auf den erkannten Text des Bildbereichs zugegriffen werden, den der Block umschließt. Die ITextBlock-Schnittstelle leitet sich von der IBlock-Schnittstelle ab und erbt alle ihre Eigenschaften. Die Eigenschaften dieses Objekts können in zwei Gruppen unterteilt werden:
  • die Eigenschaften, die den Prozess der Texterkennung im Block beeinflussen. Dazu gehören ImageProcessingParams, AnalysisParams und RecognizerParams. Mit diesen Eigenschaften können Sie spezielle Verarbeitungsparameter für einen einzelnen Block festlegen.
  • die Eigenschaften, die entweder nach der Analyse und vor der Erkennung festgelegt oder vom Programm während der Erkennung ausgefüllt werden können. Dazu gehören BlockRole und BusinessCardFieldType, mit denen die Rolle des Blocks in verschiedenen Dokumenttypen angegeben wird. Die Eigenschaft TextOrientation gehört ebenfalls zu dieser Gruppe.
  • die Erkennungsergebnisse. Diese Gruppe enthält nur die Eigenschaft Text, die den erkannten Text des Blocks darstellt.

Eigenschaften

Name

Typ

Beschreibung

Verarbeitungseinstellungen

AnalysisParams

TextBlockAnalysisParams

Ermöglicht den Zugriff auf die Analyseparameter des Textblocks.

ImageProcessingParams

ImageProcessingParams

Ermöglicht den Zugriff auf die Parameter für die Bildvorverarbeitung des Textblocks.

RecognizerParams

RecognizerParams

Ermöglicht den Zugriff auf die Erkennungsparameter des Textblocks.

Die Rolle und Orientierung des Textes

BlockRole

BlockRoleEnum

Gibt die Rolle des Textblocks in der logischen Struktur eines Dokuments an.

Standardmäßig ist der Wert BR_Unknown.

BusinessCardFieldType

BusinessCardFieldTypeEnum

Ermöglicht den Zugriff auf die Rolle des Textblocks im Kontext einer Visitenkarte.

Wenn die Methode IFRPage::SynthesizeBusinessCard aufgerufen wird, geht FineReader Engine davon aus, dass ein Block mit der angegebenen Rolle in einer Visitenkarte ein Feld des entsprechenden Typs ist. Kann der Block nicht als Feld dieses Typs betrachtet werden, wird sein Text nicht in den Text der Visitenkarte übernommen.

Standardmäßig ist der Wert BCFT_Unknown.

TextOrientation

TextOrientation

Gibt die Textorientierung im Block an. Wenn Sie sie vor der Erkennung festlegen, beeinflusst sie die Art und Weise, wie der Text im Block interpretiert wird (z. B. in Zeilen oder Spalten); andernfalls enthält sie nach der Erkennung die erkannte Orientierung.

Erkennungsergebnisse

Text

Text, nur lesbar

Enthält den erkannten Text des Textblocks.

Methoden

NameBeschreibung
CopyFromInitialisiert die Eigenschaften des aktuellen Objekts mit den Werten entsprechender Eigenschaften eines anderen Objekts.

Windows

TextBlock

Linux und macOS

TextBlockLinuxMac Objektdiagramm

Ausgabeparameter

Dieses Objekt ist der Ausgabeparameter der GetAsTextBlock-Methode des Block-Objekts.

Beispiele

int totalCharsCount = 0;
FREngine.IBlock block;
// Berechnet die Anzahl der Zeichen in einem Text
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;
 }
}
Das Objekt wird in den folgenden Codebeispielen verwendet:

Siehe auch

Block Arbeiten mit Layout und Blöcken Arbeiten mit Eigenschaften