Zum Hauptinhalt springen
Diese Methode konvertiert die Koordinaten eines Pixels von einem Änderungszustand oder einer Bildebene des ImageDocument in einen anderen.

Syntax

C++

HRESULT ConvertCoordinates(
  ImageTypeEnum FromPage,
  ImageTypeEnum ToPage,
  int*          X,
  int*          Y
);

C#

void ConvertCoordinates(
  ImageTypeEnum FromPage,
  ImageTypeEnum ToPage,
  out int       X,
  out int       Y
);

Visual Basic .NET

Sub ConvertCoordinates( _
  FromPage As ImageTypeEnum, _
  ToPage As ImageTypeEnum, _
  ByRef X As Integer, _
  ByRef Y As Integer _
)

Parameter

FromPage [in] Diese Variable vom Typ ImageTypeEnum gibt die Bildseite an, von der die Pixelkoordinaten umgerechnet werden sollen. ToPage [in] Diese Variable vom Typ 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.

Rückgabewerte

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

Hinweise

  • 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-Bildebene oder aus einer solchen zu konvertieren, die noch nicht erstellt wurde.
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 erneut auf, wenn das Bild geändert wurde.

Siehe auch

ImageTypeEnum CoordinatesConverter ImageDocument