OnToolChangeBlockRegion-Methode der IImageViewerEvents-Schnittstelle

Diese Methode wird clientseitig implementiert. Sie wird von ABBYY FineReader Engine aufgerufen, bevor die Region eines Blocks geändert wird, die mit einem der folgenden Werkzeuge des Image Viewer bearbeitet wurde:

Blockteil hinzufügen (MI_ChooseTool_AddBlockPart)
Blockteil ausschneiden (MI_ChooseTool_CutBlockPart)

In der Beschreibung der Image-Viewer-Befehle erfahren Sie, wie diese Werkzeuge ausgewählt werden können. Sie liefert dem Client Informationen zu den Blöcken, deren Regionen geändert wurden, sowie zur neuen Region des resultierenden Blocks. Die Methode wird für jeden resultierenden Block aufgerufen. Wenn beispielsweise zwei Regionen zu einem Block zusammengeführt wurden, wird die Methode nur einmal aufgerufen. Wenn Regionen von zwei Blöcken mit einem Werkzeug ausgeschnitten wurden, wird die Methode zweimal aufgerufen. Wenn ein Block mit einem Werkzeug gelöscht wurde, wird die Methode nicht aufgerufen. Mit dieser Methode kann der Vorgang abgebrochen werden.

Syntax

C++

HRESULT OnToolChangeBlockRegion(
  IIntsCollection* BlocksToChange,
  IRegion*         NewRegion,
  VARIANT_BOOL*    Cancel
);

C#

void OnToolChangeBlockRegion(
  IIntsCollection     BlocksToChange,
  IRegion         NewRegion,
  out bool       Cancel
);

Visual Basic .NET

Sub OnToolChangeBlockRegion( _
  BlocksToChange As IIntsCollection, _ _
  NewRegion As IRegion, _
  ByRef Cancel As Boolean _
)

Parameter

BlocksToChange [in] Enthält die Indizes der geänderten Blöcke im Objekt IntsCollection. Die Sammlung enthält nur dann mehr als ein Element, wenn mehrere Blöcke zu einem Block zusammengeführt wurden. NewRegion [in] Enthält die neue Region des resultierenden Blocks im Objekt Region. Cancel [out] Sie können diese Variable auf TRUE setzen, um anzugeben, dass der Vorgang abgebrochen werden soll. In diesem Fall werden die Regionen der Blöcke nicht geändert.

Rückgabewerte

[Nur C++] Wenn diese Methode einen anderen Wert als S_OK zurückgibt, weist dies darauf hin, dass clientseitig ein Fehler aufgetreten ist. In diesem Fall wird der Wert des Parameters Cancel nicht berücksichtigt.

Hinweise

Die Client-Implementierung dieser Methode muss sicherstellen, dass alle innerhalb der Methode ausgelösten Ausnahmen abgefangen und behandelt werden und dass keine Ausnahmen über die Methode hinaus weitergegeben werden. Wird eine Ausnahme über die Methode hinaus weitergegeben, kann dies zu unvorhersehbaren Ergebnissen führen (z. B. zur Beendigung des Programms).