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

# ConvertCoordinates-Methode des CoordinatesConverter-Objekts

> ConvertCoordinates-Methode des CoordinatesConverter-Objekts in der ABBYY FineReader Engine API — Konvertiert Pixelkoordinaten zwischen verschiedenen Modifikationszuständen oder Bildebenen eines ImageDocument.

Diese Methode konvertiert die Koordinaten eines Pixels von einem Änderungszustand oder einer Bildebene des [ImageDocument](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument) in einen anderen.

<div id="syntax">
  ## 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">
  ## Parameter
</div>

FromPage

\[in] Diese Variable vom Typ [ImageTypeEnum](/de/fine-reader/engine/api-reference/enumerations/imagetypeenum) gibt die Bildseite an, von der die Pixelkoordinaten umgerechnet werden sollen.

ToPage

\[in] Diese Variable vom Typ [ImageTypeEnum](/de/fine-reader/engine/api-reference/enumerations/imagetypeenum) gibt die Bildseite an, auf die die Pixelkoordinaten umgerechnet werden sollen.

X

\[in, out] Diese Variable speichert vor dem Methodenaufruf die horizontale Koordinate des Pixels relativ zur Quellbildseite und nach dem Methodenaufruf die horizontale Koordinate des Pixels relativ zur Zielbildseite.

Y

\[in, out] Diese Variable speichert vor dem Methodenaufruf die vertikale Koordinate des Pixels relativ zur Quellbildseite und nach dem Methodenaufruf die vertikale Koordinate des Pixels relativ zur Zielbildseite.

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

* Die Koordinaten der Pixel auf der Schwarzweißbildseite und der Farbbildseite sind identisch.
* Die Methode gibt einen Fehler zurück, wenn Sie versuchen, Koordinaten in eine [Vorschau](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#preview)-Bildebene oder aus einer solchen zu konvertieren, die noch nicht erstellt wurde.

<Warning>
  Eine automatische oder manuelle Änderung am Bild kann die zuvor erstellte Vorschaubildebene zurücksetzen; danach können Sie keine Koordinaten mehr in diese Vorschau oder aus ihr konvertieren. Bevor Sie Koordinaten konvertieren, rufen Sie die Methode [GetPreviewImage](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument/getpreviewimage-method) erneut auf, wenn das Bild geändert wurde.
</Warning>

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

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

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

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