Vai al contenuto principale
Questo metodo registra un comando definito dall’utente. Il comando può inoltre essere aggiunto a una barra degli strumenti o eseguito tramite il metodo ICommands::DoCommand.

Sintassi

C++

HRESULT RegisterUserCommand(
  MenuItemEnum CommandId,
  BSTR         CommandText,
  BSTR         IconPath,
  int          HotKey
);

C#

void RegisterUserCommand(
  MenuItemEnum CommandId,
  string       CommandText,
  string       IconPath,
  int          HotKey
);

Visual Basic .NET

Sub RegisterUserCommand( _
  CommandId As MenuItemEnum, _
  CommandText As String, _
  IconPath As String, _
  HotKey As Integer _
)

Parametri

CommandId [in] Specifica l’ID assegnato al comando utente come costante MenuItemEnum. Può assumere i valori MI_CustomCommand1, … , MI_CustomCommand10. CommandText [in] Specifica il testo del comando utente. IconPath [in] Specifica il percorso del file contenente un’immagine BMP di dimensioni 16х16 che verrà usata come icona del comando. HotKey [in] Specifica il tasto di scelta rapida per il comando. Il parametro ha lo stesso formato del valore restituito (LRESULT) dalla funzione Windows SendMessage per il messaggio HKM_GETHOTKEY. Per ottenere il valore del tasto di scelta rapida in questo formato, è necessario inserire il codice della chiave virtuale del tasto di scelta rapida nel byte meno significativo del valore e il modificatore che specifica i tasti che definiscono una combinazione di scelta rapida nel byte più significativo. Se non è necessario usare un tasto di scelta rapida per il comando, passare 0 a questo parametro. Se un altro comando usa questo tasto di scelta rapida, viene restituito un errore. È possibile verificare la disponibilità di un tasto di scelta rapida usando il metodo ICommands::HasHotKey.

Valori di ritorno

Questo metodo non restituisce valori di ritorno specifici. Restituisce i valori di ritorno standard delle funzioni di ABBYY FineReader Engine.

Vedere anche

Commands UnregisterUserCommand MenuItemEnum