Vai al contenuto principale
Questo metodo è implementato lato client. Viene chiamato da ABBYY FineReader Engine prima dell’esecuzione di un comando in Image Viewer, Zoom Viewer, Text Editor o Document Viewer. Di seguito sono elencati i comandi disponibili e le modalità d’uso di tali comandi in ciascun componente: Il metodo fornisce al client informazioni sul comando che sta per essere eseguito. Tramite questo metodo è possibile annullare l’operazione.

Sintassi

C++

HRESULT OnCommand(
  MenuItemEnum  MenuItem,
  VARIANT_BOOL* Cancel
);

C#

void OnCommand(
  MenuItemEnum MenuItem,
  out bool     Cancel
);

Visual Basic .NET

Sub OnCommand( _
  MenuItem As MenuItemEnum, _
  ByRef Cancel As Boolean _
)

Parametri

MenuItem [in] Questa variabile di tipo MenuItemEnum specifica il comando richiamato. Cancel [out] È possibile impostare questa variabile su TRUE per indicare che il processo deve essere interrotto. In questo caso, il comando non verrà eseguito.

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 questo 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 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

ICommandEvents Personalizzare il menu contestuale e la barra degli strumenti di un Visual Component