> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GetCharacterData-Methode des PlainText-Objekts

> GetCharacterData-Methode des PlainText-Objekts in der ABBYY FineReader Engine API — Gibt Informationen zu allen Zeichen als Arrays zurück (Seitenzahlen, Zeichenrechtecke, Konfidenzwerte) zur clientseitigen Iteration (nur Windows).

<Note>
  Diese Methode ist in FRE für Windows implementiert.
</Note>

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.

<Note>
  Unter Windows wird dies insbesondere empfohlen, wenn Ihre Anwendung über DCOM arbeitet.
</Note>

<div id="syntax">
  ## Syntax
</div>

<div id="c">
  ### C++
</div>

```cpp theme={null}
HRESULT GetCharacterData(
  SAFEARRAY** PageNumbers,
  SAFEARRAY** LeftBorders,
  SAFEARRAY** TopBorders,
  SAFEARRAY** RightBorders,
  SAFEARRAY** BottomBorders,
  SAFEARRAY** Confidences,
  SAFEARRAY** IsSuspicious
);
```

### C\#

```csharp theme={null}
void GetCharacterData(
  out int[]  PageNumbers,
  out int[]  LeftBorders,
  out int[]  TopBorders,
  out int[]  RightBorders,
  out int[]  BottomBorders,
  out int[]  Confidences,
  out bool[] IsSuspicious
);
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```vb theme={null}
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 _
)
```

<div id="parameters">
  ## Parameter
</div>

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ß](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white)-Ebene des Quellbildes.

TopBorders

\[out] Ein Array mit den Koordinaten der oberen Begrenzungen der Zeichenrechtecke relativ zur entzerrten [Schwarz-Weiß](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white)-Ebene des Quellbildes.

RightBorders

\[out] Ein Array mit den Koordinaten der rechten Begrenzungen der Zeichenrechtecke relativ zur entzerrten [Schwarz-Weiß](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white)-Ebene des Quellbildes.

BottomBorders

\[out] Ein Array mit den Koordinaten der unteren Begrenzungen der Zeichenrechtecke relativ zur entzerrten [Schwarz-Weiß](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white)-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.

<div id="return-values">
  ## Rückgabewerte
</div>

Diese Methode hat keine spezifischen Rückgabewerte. Sie gibt die [Standardrückgabewerte von ABBYY FineReader Engine-Funktionen](/de/fine-reader/engine/api-reference/return-codes) zurück.

<div id="remarks">
  ## Hinweise
</div>

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.

<div id="see-also">
  ## Siehe auch
</div>

[PlainText](/de/fine-reader/engine/api-reference/text-related-objects/plaintext)