Zum Hauptinhalt springen

Wann es ausgelöst wird

Das Ereignis tritt auf, wenn ein Benutzerbefehl aufgerufen wird (vorausgesetzt, dem Hauptmenü oder der Symbolleiste wurde ein entsprechender Eintrag hinzugefügt). Bezeichner von Benutzerbefehlen können in der Form CI_UserCommand + <nichtnegative ganze Zahl> dargestellt werden.

Parameter

NameTypZugriffDescription
CommandIdTCommandIDLesen/SchreibenDer Bezeichner des Benutzerbefehls
ContextIMainWindowLesen/SchreibenDas Hauptfenster der Anwendung
Um einen Benutzerbefehl dem Hauptmenü oder der Symbolleiste hinzuzufügen, müssen Sie die Methoden AppendItem / InsertItem und AppendButton /InsertButton der Schnittstellen IMenu bzw. IToolbar verwenden. Dabei müssen die Befehlsbezeichner CI_UserCommand oder CI_UserCommand + <nicht negative Ganzzahl> verwendet werden.
Der folgende Beispielcode zeigt, wie Sie einen Menüpunkt für einen Benutzerbefehl mit dem Befehlsbezeichner CI_UserCommand + 1 hinzufügen.
ABBYY.FlexiCapture.ClientUI.TCommandID userCommand = ABBYY.FlexiCapture.ClientUI.TCommandID.CI_UserCommand;
ABBYY.FlexiCapture.ClientUI.TCommandID userCommand1 = (ABBYY.FlexiCapture.ClientUI.TCommandID) ((int)userCommand + 1);
IMenu menu = MainWindow.MainMenu[0].Submenu;
menu.AppendItem( userCommand1, "User command" );
Eine Schaltfläche in der Symbolleiste oder ein Menüpunkt, die bzw. der für einen Benutzerbefehl hinzugefügt wurde, ist deaktiviert, sofern kein Handler für das Ereignis On User Command hinzugefügt wird. Der Beispielcode unten zeigt, wie das Ereignis On User Command verarbeitet wird.
ABBYY.FlexiCapture.ClientUI.TCommandID commandID = ( ABBYY.FlexiCapture.ClientUI.TCommandID )( CommandId );
ABBYY.FlexiCapture.ClientUI.TCommandID userCommand = ABBYY.FlexiCapture.ClientUI.TCommandID.CI_UserCommand;
ABBYY.FlexiCapture.ClientUI.TCommandID userCommand1 = (ABBYY.FlexiCapture.ClientUI.TCommandID) ((int)userCommand + 1);
if( commandID == userCommand1 ) {
<... call necessary methods here ...>