Methode OnToolChangeBlockRegion der Schnittstelle IZoomViewerEvents

Methode OnToolChangeBlockRegion der Schnittstelle IZoomViewerEvents in ABBYY FineReader Engine Visual Components unter Windows — Diese Methode wird clientseitig implementiert.

Diese Methode wird clientseitig implementiert. Sie wird von ABBYY FineReader Engine aufgerufen, bevor die Region eines Blocks geändert wird, der zuvor im Zoom Viewer mithilfe eines 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 Commands erfahren Sie, wie diese Werkzeuge ausgewählt werden können.

Sie übermittelt dem Client Informationen zu den Blöcken, deren Regionen geändert wurden, sowie zur neuen Region des resultierenden Blocks. Mithilfe dieser Methode kann der Vorgang abgebrochen werden.

​

Syntax

​

C++

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

​

C#

void OnToolChangeBlockRegion(
  IIntsCollection  blocksToChange,
  Region          NewRegion,
  out bool        Cancel
);

​

Visual Basic .NET

Sub OnToolChangeBlockRegion( _
  blocksToChange As IIntsCollection, _
  NewRegion As Region, _
  ByRef Cancel As Boolean _
)

​

Parameter

blocksToChange

[in] Enthält die Indizes der geänderten Blöcke als IntsCollection-Objekt.

NewRegion

[in] Enthält die neue Region des resultierenden Blocks als Region-Objekt.

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, bedeutet dies, 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. Die Weitergabe einer Ausnahme über die Methode hinaus kann zu unvorhersehbaren Ergebnissen führen (z. B. zum Programmabbruch).

​

Siehe auch

IZoomViewerEvents