Zum Hauptinhalt springen
Diese Methode wird clientseitig implementiert. Sie wird von ABBYY FineReader Engine aufgerufen, bevor ein Tabellenblock geändert wird, der mithilfe eines Werkzeugs von Image Viewer bearbeitet wurde: In der Beschreibung der Image Viewer Commands erfahren Sie, wie diese Werkzeuge ausgewählt werden können. Sie übergibt dem Client den Index des Tabellenblocks, der geändert werden soll, sowie die Position und den Typ der neuen oder gelöschten Trennlinie. Mithilfe dieser Methode kann der Vorgang abgebrochen werden.

​
Syntax

​
C++

HRESULT OnToolChangeTable(
  int           BlockIndex,
  int           Position,
  VARIANT_BOOL  IsVerticalSeparator,
  VARIANT_BOOL  DeleteSeparator,
  VARIANT_BOOL* Cancel
);

​
C#

void OnToolChangeTable(
  int      BlockIndex,
  int      Position,
  bool     IsVerticalSeparator,
  bool     deleteSeparator,
  out bool Cancel
);

​
Visual Basic .NET

Sub OnToolChangeTable( _
  BlockIndex As Integer, _
  Position As Integer, _
  IsVerticalSeparator As Boolean, _
  DeleteSeparator As Integer, _
  ByRef Cancel As Boolean _
)

​
Parameter

BlockIndex [in] Enthält den Index des Tabellenblocks, der geändert werden soll. Der Index ist in der ILayout::VisualBlocks-Sammlung enthalten. Position [in] Enthält die Position der Trennlinie in der Tabelle. Die Position der Trennlinie ist ihre Koordinate im Grundraster. IsVerticalSeparator [in] Gibt an, ob die Trennlinie vertikal oder horizontal ist. DeleteSeparator [in] Gibt an, ob die Trennlinie 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 die Trennlinie nicht hinzugefügt (oder gelöscht).

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

​
Anmerkungen

  • Unter dem Grundraster verstehen wir hier das Raster, das durch Tabellenränder und Trennlinien gebildet wird. Jede vertikale Trennlinie erhöht die horizontale Koordinate um eins, und jede horizontale Trennlinie erhöht die vertikale Koordinate um eins. Die Koordinatenachsen verlaufen von links nach rechts und von oben nach unten.
  • Die Client-Implementierung dieser Methode muss sicherstellen, dass alle innerhalb der Methode ausgelösten Ausnahmen abgefangen und verarbeitet werden und 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

IImageViewerEvents