Paragraph-Objekt (IParagraph-Schnittstelle)

Paragraph-Objekt (IParagraph-Schnittstelle) in der ABBYY FineReader Engine API — elementare Einheit des erkannten Textes, die Text, Absatzparameter (ExtendedParams, ListParams, ParagraphStyle), die Sammlungen Lines und Words, zeichenbezogene Parameter sowie Lesezeichen/Hyperlinks verfügbar macht.

Dieses Objekt stellt Methoden und Eigenschaften für die Arbeit mit einem einzelnen Absatz des erkannten Textes bereit.

Ein Absatz im ABBYY FineReader Engine-Objektmodell ist eine elementare Texteinheit. Über dieses Objekt kann der Benutzer Folgendes abrufen:

• den erkannten Text (verwenden Sie dafür die Eigenschaft Text)

• verschiedene Absatzparameter (die Eigenschaften ExtendedParams, ListParams und ParagraphStyle)

• Sammlungen von Absatzzeilen und -wörtern (die Eigenschaften Lines und Words)

• die Parameter eines einzelnen Zeichens (die Methoden GetCharParams, SetCharParams und GetDropCapCharParams)

• Lesezeichen (die Eigenschaften Bookmark und UserBookmark)

• Die Koordinaten der Absatzgrenzen (die Eigenschaften Left, Top, Right und Bottom) sind für Barcode-Absätze nicht verfügbar.

• Lesezeichen in ABBYY FineReader Engine sind interne (technische) oder benutzerdefinierte Entitäten mit Namen, die mithilfe von Schlüsselwörtern (Präfixen) codiert sind. Diese Schlüsselwörter und ihr Wortschatz können je nach Version der verwendeten Technologien variieren.

​

Eigenschaften

	, read-only	Gibt das Engine-Objekt zurück.
	, read-only	Ermöglicht den Zugriff auf den erkannten Text des Absatzes in Form eines Unicode-Strings. Über diese Eigenschaft wird der erkannte Text abgerufen. Dieser String kann folgende Sonderzeichen enthalten: 0x2028 — Zeilenumbruchsymbol L’\n’ — Absatzumbruchsymbol 0xFFFC — Objekt-Ersatzzeichen (kennzeichnet ein eingebettetes Bild im Text) 0x0009 — Tabulator. 0x005E — Zirkumflex (^), wird von ABBYY FineReader Engine als Ersatz für nicht erkannte Zeichen verwendet 0x00AC — Weiches Trennzeichen Wenn der Absatz eine Schreibrichtung von rechts nach links aufweist (wie z. B. bei Hebräisch), enthält der Text des Absatzes die Zeichen in der Lesereihenfolge. Beispielsweise wird der hebräische Text als der String ” ” zurückgegeben. Beachten Sie, dass der erkannte Text geringfügig vom Original abweichen kann. Einige Eingabezeichen können durch ein Sonderzeichen ersetzt werden. So kann beispielsweise das Symbol ”…” durch einen Tabulator ersetzt werden. Daher kann die Anzahl der Zeichen im erkannten Text vom Original abweichen. Um auf das Eingabewort ohne ersetzte Zeichen zuzugreifen, verwenden Sie .
	, read-only	Ermöglicht den Zugriff auf die Sammlung der Absatzwörter. Im Gegensatz zur Text-Eigenschaft enthält ein Wort im Absatz bei einer Schreibrichtung von rechts nach links (wie z. B. bei Hebräisch) die Zeichen des Wortes von links nach rechts. Beispielsweise wird das hebräische Wort als der String ” ” zurückgegeben.
	, read-only	Ermöglicht den Zugriff auf die Sammlung der Absatzzeilen. Die Eigenschaft gibt ein konstantes Objekt zurück.
	, read-only	Gibt die Anzahl der Lesezeichen im Absatz zurück.
	, read-only	Ermöglicht den Zugriff auf ein Lesezeichen beliebigen Typs (technisch oder benutzerdefiniert) über seinen Index in der internen Sammlung der Absatz-Lesezeichen. Das über diese Eigenschaft abgerufene Lesezeichen enthält ein Präfix in seinem Namen.
	, read-only	Gibt einen Verweis auf das Hyperlink-Objekt zurück, das beschreibt den Hyperlink an der Position. Wenn kein Hyperlink vorhanden ist, wird diese Eigenschaft auf 0 gesetzt.
	, read-only	Ermöglicht den Zugriff auf alle Tabstopps im Absatz.
	, nur lesbar	Ermöglicht den Zugriff auf das Benutzer-Lesezeichen über seinen Index in der internen Sammlung der Absatz-Lesezeichen. Das über diese Eigenschaft abgerufene Lesezeichen enthält kein Präfix in seinem Namen.
	, nur lesbar	Gibt die Anzahl der Benutzer-Lesezeichen im Absatz zurück.
	, nur lesbar	Diese Eigenschaft enthält die Anzahl der Zeichen im Absatz. Dieser Wert entspricht der Anzahl der Zeichen in der Zeichenkette, die über die Eigenschaft Text abgerufen wird. Das Absatzumbruchzeichen am Ende des Absatzes ist in der Eigenschaft Text enthalten und wird in der Eigenschaft Length mitgezählt.
		Ermöglicht den Zugriff auf die Parameter des Paragraph Objekts, die vom ParagraphParams-Objekt bereitgestellt werden.
	, read-only	Ermöglicht den Zugriff auf die Parameter der Liste, zu der der Absatz gehört. Wenn der Absatz nicht in der Liste enthalten ist, gibt die Eigenschaft IListParams::List NULL zurück.
		Ermöglicht den Zugriff auf die Parameter des Absatzstils. Diese Parameter sind erst nach der Dokumentsynthese verfügbar. Die Eigenschaft gibt ein konstantes Objekt zurück.
		Ermöglicht den Zugriff auf die Anzahl der Zeichen im Initialbuchstaben eines Absatzes. Die ersten DropCapCharsCount Symbole des Absatzes werden als Initialbuchstabe behandelt. Diese Eigenschaft wird beim Bearbeiten des Absatzes nicht aktualisiert und kann daher größer als die Länge des Absatzes sein.
	, nur lesbar	Enthält die Nummer der Spalte, zu der das Zeichen an der Position gehört.
	, nur lesbar	Enthält die Koordinate des unteren Rands des Absatzes, wie er auf dem Bild positioniert ist. Diese Eigenschaft ist für Absätze von Barcodes nicht verfügbar.
	, nur lesbar	Speichert die Koordinate des linken Rands des Absatzes gemäß seiner Position im Bild. Diese Eigenschaft ist für die Absätze von Barcodes nicht verfügbar.
	, nur lesbar	Speichert die Koordinate des rechten Rands des Absatzes gemäß seiner Position im Bild. Diese Eigenschaft ist für die Absätze von Barcodes nicht verfügbar.
	, nur lesbar	Speichert die Koordinate des oberen Rands des Absatzes gemäß seiner Position im Bild. Diese Eigenschaft ist für die Absätze von Barcodes nicht verfügbar.

​

Methoden

Name	Beschreibung
DeleteBookmark	Löscht das angegebene Lesezeichen beliebigen Typs (technisch oder benutzerdefiniert) aus dem Absatz.
GetBookmarkRange	Ermittelt anhand des Namens des Lesezeichens den Index des ersten Zeichens und die Länge der Zeichenfolge, die das Lesezeichen bildet.
GetCharParams	Ermöglicht den Zugriff auf die Parameter eines einzelnen Zeichens.
GetDropCapCharParams	Ermöglicht den Zugriff auf die Parameter einer Initiale im Absatz.
GetHyperlinkRange	Analysiert ein einzelnes Hyperlink-Zeichen und ermittelt den Index des ersten Zeichens sowie die Länge der Zeichenfolge, die den Hyperlink bildet.
GetWordRecognitionVariants	Gibt eine Sammlung von Varianten der Erkennung eines Worts an der aktuellen Position im Text eines Absatzes zurück.
Insert	Fügt eine Zeichenfolge in den Text des Absatzes ein.
InsertParagraphBreak	Teilt den Absatz in zwei Teile.
InsertTab	Fügt an der ausgewählten Position im Text einen Tabstopp ein.
InsertText	Fügt den angegebenen Text in den Text des Absatzes ein.
NextGroup	Findet das nächste Zeichen im Absatz, dessen ausgewählte Parameter sich von denen des Zeichens unterscheiden, bei dem die Suche beginnt. Diese Methode kann verwendet werden, um alle fett oder kursiv formatierten Wörter im Absatz, alle unsicher erkannten Zeichen usw. zu finden.
Range	Gibt eine Teilzeichenfolge aus dem Text des Absatzes zurück.
Remove	Löscht einen Bereich aus dem Text des Absatzes.
SetBookmark	Legt für eine Zeichenfolge innerhalb eines Absatzes ein benutzerdefiniertes Lesezeichen fest.
SetCharParams	Legt Parameter für eine Gruppe von Zeichen fest.
SetHyperlink	Legt für eine Zeichenfolge innerhalb eines Absatzes einen Hyperlink fest.

​

Zugehörige Objekte

Objektdiagramm

​

Ausgabeparameter

Dieses Objekt ist der Ausgabeparameter der folgenden Methoden:

• Item-Methode des Paragraphs-Objekts

​

Eingabeparameter

Dieses Objekt ist der Eingabeparameter der Methode IndexOf des Objekts Paragraphs.

​

Beispiele

C#-Code

FREngine.IBlock block;
int suspiciousCharsCount = 0;
// Durchläuft die Absätze eines Textblocks und berechnet die Anzahl verdächtiger Zeichen
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;
 FREngine.ICharParams charParams = engine.CreateCharParams();
 for (int iChar = 0; iChar < text.Length; iChar++)
 {
  par.GetCharParams(iChar, charParams);
  if (charParams.IsSuspicious)
  {
   suspiciousCharsCount++;
  }
 }
}

Das Objekt wird in den folgenden Codebeispielen verwendet:

• Linux: CustomLanguage
• Windows: CustomLanguage, RecognizedTextProcessing sowie in den Demo Tools: Engine Predefined Processing Profiles

​

Siehe auch

Paragraphs

Arbeiten mit Text

Arbeiten mit Eigenschaften