Kontextmenü und Symbolleiste einer visuellen Komponente anpassen

• Der Standardteil des Kontextmenüs ist der Teil, der in der Komponente standardmäßig angezeigt wird. Dieser Teil kann nicht geändert werden. Sie können ihn nur ein- oder ausblenden.
• Der benutzerdefinierte Teil des Kontextmenüs kann bearbeitet werden. Standardmäßig ist er leer. Sie können diesem Teil des Kontextmenüs beliebige für die Komponente verfügbare Standardbefehle oder beliebige benutzerdefinierte Befehle hinzufügen. Der benutzerdefinierte Teil des Kontextmenüs wird immer nach dem Standardteil angezeigt. Er kann außerdem aktiviert oder deaktiviert werden.

​

Verfügbare Befehle verwalten

• durch Auswählen eines Eintrags in einem Kontextmenü,
• durch Klicken auf eine Schaltfläche in der Symbolleiste,
• durch Drücken einer Tastenkombination,
• durch Verwenden der Methode DoCommand des Unterobjekts Commands einer Komponente.

• Image Viewer-Befehle
• Zoom Viewer-Befehle
• Document Viewer-Befehle
• Text Editor-Befehle

​

Vordefinierte Befehle zur Symbolleiste hinzufügen

1. Rufen Sie das Objekt Toolbar über die Eigenschaft Toolbar der Komponente ab.
2. Fügen Sie den Befehl mit der Methode InsertAt des Objekts Toolbar an der gewünschten Position in die Symbolleiste ein, oder entfernen Sie ihn mit der Methode Delete oder DeleteAt.

// Wir fügen den vordefinierten Befehl MI_InvertImage am Anfang der Symbolleiste von Image Viewer hinzu
private FineReaderVisualComponents.AxImageViewer imageViewer;
imageViewer.Toolbar.InsertAt(FineReaderVisualComponents.MenuItemEnum.MI_InvertImage, 0);

​

Vordefinierte Befehle zum Kontextmenü hinzufügen

1. Rufen Sie das Objekt PopupMenu über die Eigenschaft PopupMenu der Komponente ab.
2. Deaktivieren Sie bei Bedarf den gesamten Standardteil des Kontextmenüs mit der Eigenschaft StandardMenuEnabled des Objekts PopupMenu. Standardmäßig ist der Standardteil aktiviert.
3. Aktivieren Sie den benutzerdefinierten Teil des Kontextmenüs mit der Eigenschaft CustomMenuEnabled des Objekts PopupMenu.
4. Fügen Sie mit der Methode InsertAt des Objekts PopupMenu einen Befehl an der ausgewählten Position im benutzerdefinierten Teil des Kontextmenüs ein oder entfernen Sie ihn mit der Methode Delete oder DeleteAt.

// Wir fügen den vordefinierten Befehl MI_InvertImage am Anfang des benutzerdefinierten Teils des Kontextmenüs von Image Viewer hinzu
private FineReaderVisualComponents.AxImageViewer imageViewer;
imageViewer.PopupMenu.StandardMenuEnabled = false;
imageViewer.PopupMenu.CustomMenuEnabled = true;
imageViewer.PopupMenu.InsertAt(FineReaderVisualComponents.MenuItemEnum.MI_InvertImage, 0);

​

Erstellen benutzerdefinierter Befehle

1. Registrieren Sie den Befehl in der Komponente. Verwenden Sie dazu die Methode RegisterUserCommand des Unterobjekts Commands der Komponente und übergeben Sie eine der Konstanten MI_CustomCommand1, … MI_CustomCommand10 als Parameter. Außerdem sollten Sie in den Parametern dieser Methode den Pfad zum Symbol, den Text des Befehls und das Tastenkürzel angeben.

2. Implementieren Sie das Ereignis OnCommand der Schnittstelle ICommandEvents, damit das Ereignis für den neuen Befehl verarbeitet wird. Siehe Arbeiten mit verknüpfbaren Objekten.
3. Fügen Sie den Befehl der Symbolleiste oder dem benutzerdefinierten Teil des Kontextmenüs der Komponente hinzu. Das Vorgehen ist dasselbe wie bei vordefinierten Befehlen einer Symbolleiste oder eines Kontextmenüs.

private FineReaderVisualComponents.AxImageViewer imageViewer;
private FineReaderVisualComponents.AxTextEditor textEditor;
private const int HotkeyShift = 1;
private const int HotkeyControl = 2;
private const int HotkeyAlt = 4;
// Erstellen des Tastenkürzelwerts
private int makeWord(int keyCode, int modifierFlags)
{
 return (int)((uint)((byte)(keyCode)) | ((uint)((byte)(modifierFlags)) << 8));
}
// Hinzufügen benutzerdefinierter Befehle
private void addCommands()
{
 …
 int hotKey = makeWord((int)Keys.B, HotkeyShift);
 imageViewer.Commands.RegisterUserCommand(FineReaderVisualComponents.MenuItemEnum.MI_CustomCommand1, "MyCommand", "D:\\img.bmp", hotKey);
 imageViewer.Toolbar.InsertAt(FineReaderVisualComponents.MenuItemEnum.MI_CustomCommand1, 0);
 imageViewer.Commands.OnCommand += new FineReaderVisualComponents.DICommandEvents_OnCommandEventHandler( imageViewer_OnCommand );
 hotKey = makeWord((int)Keys.T, HotkeyAlt | HotkeyShift);
 textEditor.Commands.RegisterUserCommand(FineReaderVisualComponents.MenuItemEnum.MI_CustomCommand1, "MyTextCommand", "", hotKey);
 …
}
// Handler für das OnCommand-Ereignis des Image Viewer
private void imageViewer_OnCommand( FineReaderVisualComponents.MenuItemEnum command, out bool cancel ){
 if( command == FineReaderVisualComponents.MenuItemEnum.MI_CustomCommand1 )
 {
  ...
 }
}

1. Entfernen Sie ihn aus der Symbolleiste oder aus dem benutzerdefinierten Teil des Kontextmenüs. Das Vorgehen ist dasselbe wie bei vordefinierten Befehlen einer Symbolleiste oder eines Kontextmenüs.
2. Heben Sie die Registrierung des Befehls auf. Verwenden Sie dazu die Methode UnregisterUserCommand des Unterobjekts Commands der Komponente.

​

Siehe auch