GetCharacterData-Methode des PlainText-Objekts

Diese Methode ist in FRE für Windows implementiert.

Diese Methode gibt Informationen zu allen Zeichen im Text in Form mehrerer Arrays zurück: die Seitenzahlen, auf denen sich die Zeichen befinden, die Koordinaten der Zeichenrechtecke und die Konfidenzwerte der Zeichen. Anschließend können Sie die Daten in Ihrer Anwendung durchlaufen und so das potenziell zeitaufwendige Durchlaufen von Textblöcken und Absätzen vermeiden.

Unter Windows wird dies insbesondere empfohlen, wenn Ihre Anwendung über DCOM arbeitet.

Syntax

C++

HRESULT GetCharacterData(
  SAFEARRAY** PageNumbers,
  SAFEARRAY** LeftBorders,
  SAFEARRAY** TopBorders,
  SAFEARRAY** RightBorders,
  SAFEARRAY** BottomBorders,
  SAFEARRAY** Confidences,
  SAFEARRAY** IsSuspicious
);

C#

void GetCharacterData(
  out int[]  PageNumbers,
  out int[]  LeftBorders,
  out int[]  TopBorders,
  out int[]  RightBorders,
  out int[]  BottomBorders,
  out int[]  Confidences,
  out bool[] IsSuspicious
);

Visual Basic .NET

Sub GetCharacterData( _
  ByRef PageNumbers() As Integer, _
  ByRef LeftBorders() As Integer, _
  ByRef TopBorders() As Integer, _
  ByRef RightBorders() As Integer, _
  ByRef BottomBorders() As Integer, _
  ByRef Confidences() As Integer, _
  ByRef IsSuspicious() As Boolean _
)

Parameter

PageNumbers [out] Ein Array von Seitenzahlen, auf denen sich die Zeichen befinden. LeftBorders [out] Ein Array mit den Koordinaten der linken Begrenzungen der Zeichenrechtecke relativ zur entzerrten Schwarz-Weiß-Ebene des Quellbildes. TopBorders [out] Ein Array mit den Koordinaten der oberen Begrenzungen der Zeichenrechtecke relativ zur entzerrten Schwarz-Weiß-Ebene des Quellbildes. RightBorders [out] Ein Array mit den Koordinaten der rechten Begrenzungen der Zeichenrechtecke relativ zur entzerrten Schwarz-Weiß-Ebene des Quellbildes. BottomBorders [out] Ein Array mit den Koordinaten der unteren Begrenzungen der Zeichenrechtecke relativ zur entzerrten Schwarz-Weiß-Ebene des Quellbildes. Confidences [out] Ein Array von Konfidenzwerten der Zeichen. IsSuspicious [out] Ein Array boolescher Werte, das angibt, ob die Zeichen mit geringer Sicherheit erkannt wurden.

Rückgabewerte

Diese Methode hat keine spezifischen Rückgabewerte. Sie gibt die Standardrückgabewerte von ABBYY FineReader Engine-Funktionen zurück.

Hinweise

Sie müssen die Arrays vor dem Methodenaufruf nicht manuell erstellen; sie werden von der Methode intern erzeugt. Sie sind jedoch dafür verantwortlich, die Arrays freizugeben, sobald sie nicht mehr benötigt werden, indem Sie die Methode SafeArrayDestroy aufrufen.