Vai al contenuto principale
Questo metodo è implementato sul lato client. Viene chiamato da ABBYY FineReader Engine prima di modificare una regione del blocco già modificata mediante uno dei seguenti strumenti di Image Viewer: Per sapere come selezionare questi strumenti, vedere la descrizione di Image Viewer Commands. Fornisce al client informazioni sui blocchi le cui regioni sono state modificate e sulla nuova regione del blocco risultante. Il metodo viene chiamato per ogni blocco risultante. Ad esempio, se due regioni vengono unite in un unico blocco, il metodo viene chiamato una sola volta. Se le regioni di due blocchi vengono tagliate con uno strumento, il metodo viene chiamato due volte. Se un blocco viene eliminato con uno strumento, il metodo non viene chiamato. Tramite questo metodo è possibile annullare l’operazione.

​
Sintassi

​
C++

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

​
C#

void OnToolChangeBlockRegion(
  IIntsCollection     BlocksToChange,
  IRegion         NewRegion,
  out bool       Cancel
);

​
Visual Basic .NET

Sub OnToolChangeBlockRegion( _
  BlocksToChange As IIntsCollection, _ _
  NewRegion As IRegion, _
  ByRef Cancel As Boolean _
)

​
Parametri

BlocksToChange [in] Contiene gli indici dei blocchi modificati sotto forma di oggetto IntsCollection. La raccolta contiene più di un elemento solo se più blocchi sono stati uniti in un unico blocco. NewRegion [in] Contiene la nuova regione del blocco risultante sotto forma di oggetto Region. Cancel [out] È possibile impostare questa variabile su TRUE per indicare che il processo deve essere interrotto. In questo caso, le regioni dei blocchi non verranno modificate.

​
Valori di ritorno

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

​
Note

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 si propaghi 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