Método OnToolChangeTable de la interfaz IImageViewerEvents

Este método se implementa del lado del cliente. ABBYY FineReader Engine lo llama antes de cambiar un bloque de la tabla que se ha modificado mediante una herramienta de Image Viewer:

• Agregar separador vertical (MI_ChooseTool_AddVertSeparator)
• Agregar separador horizontal (MI_ChooseTool_AddHorizSeparator)
• Eliminar separador (MI_ChooseTool_DeleteSeparator)

Consulte la descripción de Image Viewer Commands para saber cómo se pueden seleccionar estas herramientas.

Proporciona al cliente el índice del bloque de la tabla que se va a cambiar, así como la posición y el tipo del separador nuevo o eliminado. Este método también permite cancelar la operación.

​

Sintaxis

​

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

​

Parámetros

BlockIndex

[in] Contiene el índice del bloque de la tabla que se va a modificar. El índice se encuentra en la colección ILayout::VisualBlocks.

Position

[in] Contiene la posición del separador en la tabla. La posición del separador es su coordenada en una cuadrícula base.

IsVerticalSeparator

[in] Especifica si el separador es vertical u horizontal.

DeleteSeparator

[in] Especifica si el separador se va a eliminar o a añadir.

Cancel

[out] Puede establecer esta variable en TRUE para indicar que el proceso debe interrumpirse. En este caso, el separador no se añadirá (o eliminará).

​

Valores de retorno

[Solo C++] Si este método devuelve un valor distinto de S_OK, significa que se produjo un error del lado del cliente y, en ese caso, no se tiene en cuenta el valor del parámetro Cancel.

​

Observaciones

• Aquí, por cuadrícula base nos referimos a la cuadrícula formada por los bordes y separadores de la tabla. Cada separador vertical incrementa en uno la coordenada horizontal, y cada separador horizontal incrementa en uno la coordenada vertical. Los ejes de coordenadas están orientados de izquierda a derecha y de arriba abajo.
• La implementación cliente de este método debe garantizar que todas las excepciones que se produzcan dentro del método se capturen y se gestionen, y que ninguna excepción se propague fuera del método. La propagación de una excepción fuera del método puede dar lugar a resultados impredecibles (como la finalización del programa).

​

Consulte también

IImageViewerEvents