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

# CoordinatesConverter オブジェクトの ConvertCoordinates メソッド

> ABBYY FineReader Engine API の CoordinatesConverter オブジェクトの ConvertCoordinates メソッド — ImageDocument の異なる変更状態または画像プレーン間でピクセル座標を変換します。

このメソッドは、[ImageDocument](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument) の異なる変更状態または画像プレーン間で、ピクセル座標を変換します。

<div id="syntax">
  ## 構文
</div>

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

```cpp theme={null}
HRESULT ConvertCoordinates(
  ImageTypeEnum FromPage,
  ImageTypeEnum ToPage,
  int*          X,
  int*          Y
);
```

### C\#

```csharp theme={null}
void ConvertCoordinates(
  ImageTypeEnum FromPage,
  ImageTypeEnum ToPage,
  out int       X,
  out int       Y
);
```

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

```vb theme={null}
Sub ConvertCoordinates( _
  FromPage As ImageTypeEnum, _
  ToPage As ImageTypeEnum, _
  ByRef X As Integer, _
  ByRef Y As Integer _
)
```

<div id="parameters">
  ## パラメーター
</div>

FromPage

\[in] この [ImageTypeEnum](/ja/fine-reader/engine/api-reference/enumerations/imagetypeenum) 型の変数は、ピクセル座標の変換元となる画像ページを指定します。

ToPage

\[in] この [ImageTypeEnum](/ja/fine-reader/engine/api-reference/enumerations/imagetypeenum) 型の変数は、ピクセル座標の変換先となる画像ページを指定します。

X

\[in, out] この変数には、メソッド呼び出し前は変換元の画像ページを基準としたピクセルの水平方向の座標が格納され、メソッド呼び出し後は変換先の画像ページを基準としたピクセルの水平方向の座標が格納されます。

Y

\[in, out] この変数には、メソッド呼び出し前は変換元の画像ページを基準としたピクセルの垂直方向の座標が格納され、メソッド呼び出し後は変換先の画像ページを基準としたピクセルの垂直方向の座標が格納されます。

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

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

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

* 白黒画像ページとカラー画像ページでは、ピクセル座標は同一です。
* まだ作成されていない[プレビュー](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#preview)画像プレーンとの間で座標を変換しようとすると、このメソッドはエラーを返します。

<Warning>
  自動または手動で画像を変更すると、以前に作成したプレビュー画像プレーンがリセットされ、そのプレビューとの間で座標を変換できなくなる場合があります。座標を変換する前に、画像が変更されている場合は、[GetPreviewImage](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument/getpreviewimage-method) メソッドを再度呼び出してください。
</Warning>

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

[ImageTypeEnum](/ja/fine-reader/engine/api-reference/enumerations/imagetypeenum)

[CoordinatesConverter](/ja/fine-reader/engine/api-reference/image-related-objects/coordinatesconverter)

[ImageDocument](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument)