> ## 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.

# PlainText オブジェクトの GetCharacterData メソッド

> ABBYY FineReader Engine API の PlainText オブジェクトの GetCharacterData メソッド — すべての文字に関する情報を配列（ページ番号、文字の矩形、信頼度）として返し、クライアント側で反復処理を行えるようにします（Windows のみ）。

<Note>
  このメソッドは、Windows 版 FRE で実装されています。
</Note>

このメソッドは、テキスト内のすべての文字に関する情報を複数の配列として返します。具体的には、各文字が存在するページ番号、各文字の矩形の座標、および各文字の信頼度です。

これにより、取得したデータをアプリケーション側で順に処理できるため、時間のかかる可能性があるテキストブロックや段落の反復処理を回避できます。

<Note>
  Windows では、特にアプリケーションが DCOM 経由で動作している場合に、この方法を推奨します。
</Note>

<div id="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">
  ## パラメーター
</div>

PageNumbers

\[out] 文字が存在するページ番号の配列。

LeftBorders

\[out] ソース画像の傾き補正済みの[白黒](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white)プレーンを基準とした、文字の矩形の左境界座標の配列。

TopBorders

\[out] ソース画像の傾き補正済みの[白黒](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white)プレーンを基準とした、文字の矩形の上境界座標の配列。

RightBorders

\[out] ソース画像の傾き補正済みの[白黒](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white)プレーンを基準とした、文字の矩形の右境界座標の配列。

BottomBorders

\[out] ソース画像の傾き補正済みの[白黒](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white)プレーンを基準とした、文字の矩形の下境界座標の配列。

Confidences

\[out] 各文字の信頼度の配列。

IsSuspicious

\[out] 文字の認識結果が疑わしいかどうかを示すブール値の配列。

<div id="return-values">
  ## 戻り値
</div>

このメソッドに固有の戻り値はありません。[ABBYY FineReader Engine 関数の標準の戻り値](/ja/fine-reader/engine/api-reference/return-codes)が返されます。

<div id="remarks">
  ## 備考
</div>

メソッドを呼び出す前に配列を手動で作成する必要はありません。配列はメソッド内部で作成されます。ただし、不要になった配列は、SafeArrayDestroy メソッドを呼び出して破棄する必要があります。

<div id="see-also">
  ## 関連項目
</div>

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