Vai al contenuto principale
Questo metodo è implementato lato client. Viene chiamato da ABBYY FineReader Engine quando il cursore della barra di scorrimento viene spostato tramite un’azione del mouse o della tastiera in Image Viewer, Zoom Viewer, Text Editor, Text Validator o Document Viewer. Passa al client il codice della barra di scorrimento, la posizione del cursore di scorrimento e il numero di righe scorse. Con questo metodo è possibile annullare l’operazione.

​
Sintassi

​
C++

HRESULT OnScroll(
  int           HorzScrollBarCode,
  int           VertScrollBarCode,
  int           Position,
  int           Count,
  VARIANT_BOOL* Cancel
);

​
C#

void OnScroll(
  int      HorzScrollBarCode,
  int      VertScrollBarCode,
  int      Position,
  int      Count,
  out bool Cancel
);

​
Visual Basic .NET

Sub OnScroll( _
  HorzScrollBarCode As Integer, _
  VertScrollBarCode As Integer, _
  Position As Integer, _
  Count As Integer, _
  ByRef Cancel As Boolean _
)

​
Parametri

HorzScrollBarCode [in] Specifica un codice della barra di scorrimento che indica la richiesta di scorrimento dell’utente. Questo parametro può assumere uno dei valori seguenti:
  • SB_LEFT (6) — Scorre completamente a sinistra.
  • SB_ENDSCROLL (8) — Termina lo scorrimento.
  • SB_LINELEFT (0) — Scorre a sinistra.
  • SB_LINERIGHT (1) — Scorre a destra.
  • SB_PAGELEFT (2) — Scorre di una pagina a sinistra.
  • SB_PAGERIGHT (3) — Scorre di una pagina a destra.
  • SB_RIGHT (7) — Scorre completamente a destra.
  • SB_THUMBPOSITION (4) — Scorre fino alla posizione assoluta. La posizione corrente è specificata dal parametro Position.
  • SB_THUMBTRACK (5) — Trascina il riquadro di scorrimento fino alla posizione specificata. La posizione corrente è specificata dal parametro Position.
Le costanti sono definite in Winuser.h. Il parametro è -1 se non si è verificato alcuno scorrimento orizzontale. VertScrollBarCode [in] Specifica un codice della barra di scorrimento che indica la richiesta di scorrimento dell’utente. Questo parametro può assumere uno dei valori seguenti:
  • SB_BOTTOM (7) — Scorre fino in fondo.
  • SB_ENDSCROLL (8) — Termina lo scorrimento.
  • SB_LINEDOWN (1) — Scorre in basso di una riga.
  • SB_LINEUP (0) — Scorre in alto di una riga.
  • SB_PAGEDOWN (3) — Scorre in basso di una pagina.
  • SB_PAGEUP (2) — Scorre in alto di una pagina.
  • SB_THUMBPOSITION (4) — Scorre fino alla posizione assoluta. La posizione corrente è specificata dal parametro Position.
  • SB_THUMBTRACK (5) — Trascina il riquadro di scorrimento fino alla posizione specificata. La posizione corrente è specificata dal parametro Position.
  • SB_TOP (6) — Scorre fino all’inizio.
Le costanti sono definite in Winuser.h. Il parametro è -1 se non si è verificato alcuno scorrimento verticale. Position [in] Specifica la posizione del riquadro di scorrimento se il codice della barra di scorrimento è SB_THUMBPOSITION o SB_THUMBTRACK; altrimenti non viene utilizzato. Count [in] Contiene il numero di righe scorse se lo scorrimento è stato eseguito con la rotellina del mouse. Cancel [out] È possibile impostare questa variabile su TRUE per indicare che il processo deve essere terminato.

​
Valori di ritorno

[Solo 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 preso in considerazione.

​
Osservazioni

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

IInputEvents