OnToolChangeTable-Methode der IZoomViewerEvents-Schnittstelle
Diese Methode wird clientseitig implementiert. Sie wird von ABBYY FineReader Engine aufgerufen, bevor ein Tabellenblock geändert wird, der im Zoom Viewer mithilfe eines Werkzeugs aus dem Image Viewer bearbeitet wurde:
In der Beschreibung der Image Viewer Commands erfahren Sie, wie diese Werkzeuge ausgewählt werden können.An den Client werden der Index des Tabellenblocks, der geändert werden soll, sowie die Position und der Typ des neuen oder gelöschten Trenners übergeben. Mit dieser Methode kann der Vorgang abgebrochen werden.
Sub OnToolChangeTable( _ BlockIndex As Integer, _ Position As Integer, _ IsVerticalSeparator As Boolean, _ DeleteSeparator As Integer, _ ByRef Cancel As Boolean _)
BlockIndex[in] Enthält den Index des Tabellenblocks, der geändert werden soll. Der Index befindet sich in der Sammlung ILayout::VisualBlocks.Position[in] Enthält die Position des Trenners in der Tabelle. Die Position des Trenners ist seine Koordinate in einem Grundraster.IsVerticalSeparator[in] Gibt an, ob der Trenner vertikal oder horizontal ist.DeleteSeparator[in] Gibt an, ob der Trenner gelöscht oder hinzugefügt werden soll.Cancel[out] Sie können diese Variable auf TRUE setzen, um anzugeben, dass der Vorgang abgebrochen werden soll. In diesem Fall wird der Trenner nicht hinzugefügt (oder gelöscht).
[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.
Die Client-Implementierung dieser Methode muss sicherstellen, dass alle innerhalb der Methode ausgelösten Ausnahmen abgefangen und behandelt werden und dass keine Ausnahmen aus der Methode nach außen weitergegeben werden. Die Weitergabe einer Ausnahme aus der Methode nach außen kann zu unvorhersehbaren Ergebnissen führen (etwa zur Beendigung des Programms).