Vai al contenuto principale
Questo metodo è implementato sul lato client. Viene chiamato da ABBYY FineReader Engine prima di modificare un blocco di tabella che è stato modificato mediante uno strumento di Image Viewer: Consulta la descrizione di Image Viewer Commands per sapere come selezionare questi strumenti. Passa al client l’indice del blocco di tabella che sta per essere modificato, nonché la posizione e il tipo del Separator nuovo o eliminato. Tramite questo metodo è possibile annullare l’operazione.

Sintassi

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 _
)

Parametri

BlockIndex [in] Contiene l’indice del blocco della tabella che verrà modificato. L’indice si trova nella raccolta ILayout::VisualBlocks. Position [in] Contiene la posizione del Separator nella tabella. La posizione del Separator corrisponde alla sua coordinata nella griglia di base. IsVerticalSeparator [in] Specifica se il Separator è verticale o orizzontale. DeleteSeparator [in] Specifica se il Separator verrà eliminato o aggiunto. Cancel [out] È possibile impostare questa variabile su TRUE per indicare che il processo deve essere interrotto. In questo caso, il Separator non verrà aggiunto (o eliminato).

Valori di ritorno

[Solo in C++] Se questo method restituisce un valore diverso da S_OK, significa che si è verificato un errore sul lato client e, in tal caso, il valore del parametro Cancel non viene preso in considerazione.

Osservazioni

  • Per griglia di base si intende la griglia formata dai bordi della tabella e dai Separator. Ogni Separator verticale aumenta di uno la coordinata orizzontale e ogni Separator orizzontale aumenta di uno la coordinata verticale. Gli assi cartesiani sono orientati da sinistra a destra e dall’alto verso il basso.
  • L’implementazione client di questo metodo deve garantire che tutte le eccezioni generate all’interno del metodo vengano intercettate e gestite e che nessuna eccezione venga propagata all’esterno del metodo. La propagazione di un’eccezione all’esterno del metodo può causare risultati imprevedibili, come la terminazione del programma.

Vedi anche

IImageViewerEvents