Office Manager Entwickler-Support

Das Benutzermenü mit eigenen Befehlen erweitern

Mit Hilfe der Datei "usermenu.ini" können Sie dem Hauptmenü eigene Befehle hinzufügen. Dies stellt eine einfache Möglich dar, das Dokumenten-Management-System an eigene Anforderungen anzupassen (Customizing). Die so erstellten Befehle sind allgemeingültig und unabhängig von der Markierung im Dokumentenarchiv.

Alternativ können auch dokumenttypspezifische Erweiterungen vorgenommen werden. Dies ist erforderlich, wenn die Funktion nur für bestimmte Dokumenttypen, wie beispielsweise Adobe Acrobat oder Excel gültig ist.

Konfigurationsdatei usermenu.ini

Die Datei "usermenu.ini" wird im Verzeichnis der gemeinsamen Dateien abgelegt, sie hat folgenden Aufbau:

; Kommentare werden in einer INI-Datei mit Semikolon eingeleitet [Befehlsname 1] Parent=Name des Hauptmenüs FileMustExists=optionaler Name einer erforderlichen Datei Position=Position im Menü BeginGroupInMenu=bei 1 wird im Menü vor dem Befehl eine Linie gezeichnet BeginGroupOnBar=bei 1 wird auf der Toolbar eine Trennlinie gezeichnet Caption=Text des Menüeintrags Glyph=Menüsymbol ShowOnToolbar=bei 1 erscheint der Befehl auch auf der Symbolleiste Hint=Kurzhilfe HelpContext=Nummer der Onlinehilfe MacroCmd=auszuführender OmAPI-Makrobefehl [Befehlsname 2] ...

Beschreibung der INI-Schlüssel

`[BefehlsName]`

Jeder Menübefehl wird in einer eigenen Sektion definiert, die Sektion beginnt mit dem Befehlsnamen in eckigen Klammern. Der Name kann beliebig gewählt werden, er muss aber eindeutig sein. Die empfohlene Syntax ist: "usrM" gefolgt vom englischen Namen des Hauptmenüs und einem englischen Namen des Befehls. Beispielsweise "[usrMFileOpenTestPdf]" für einen Befehl im Dateimenü, der das Dokument test.pdf öffnet.

`Parent`

Name des Haupt- oder Untermenüs, in welchem der Befehl dargestellt wird. Gültige Namen sind u. a.:

MainMenuFile ( = Menü Datei),
MainMenuDocument (Dokument),
MainMenuEdit (Bearbeiten),
MainMenuSearch (Suchen),
MainMenuView (Ansicht),
MainMenuHelp (Hilfe),
MainMenuAdmin (Administrator),
MFileSubDB (Datei | Datenbank),
MDocSubNew (Dokument | Neu),
MainMenuOptions (Ansicht | Optionen).

Eine vollständige Liste finden Sie in der Windows-Registry unter "HCU\Software\Krekeler\Office Manager …\Component Settings\FormOmMain.MainMenu". Die Menünamen stehen dort jeweils hinter dem Text "SubItem_".
Der Befehl wird ignoriert, wenn Parent keinen gültigen Namen enthält.

`FileMustExists`

Optionale Angabe eines Dateinamen. Falls angegeben, wird der Menüeintrag nur erstellt, wenn die genannte Datei vorhanden ist. Dies ist beispielsweise sinnvoll, wenn mit dem neuen Befehl ein Hilfedokument geöffnet werden soll. Ist das Dokument auf einem Rechner nicht vorhanden, dann wird der Befehl auf diesem nicht eingeblendet.

`Position`

Gibt die Position im Menü an: 0=an letzter Position, 1=an erster Position. 2=an zweiter usw. Um Index-Fehler zu vermeiden, sollte 0 oder 1 verwendet werden.

`BeginGroupInMenu`

0 oder 1. Bei 1 wird vor dem neuen Befehl eine Gruppierungs-Linie im Menü gezeichnet.

`BeginGroupOnBar`

0 oder 1. Bei 1 wird auf der Toolbar eine Trennlinie gezeichnet.

`Caption`

Der Text des Menüeintrages. Dieser sollte dem Anwender kurz und eindeutig die Funktion beschreiben.

`Glyph`

Dateiname des Menüsymbols. Geben Sie bitte den Namen einer Bitmap (*.bmp) mit 16×16 Pixel an. Wenn Sie die Datei ohne vollständigen Pfad angeben, dann wird sie im Verzeichnis der gemeinsamen Dateien erwartet.
Oder: Index des programminternen Menüsymbols (0 bis n).

`ShowOnToolbar`

0 oder 1. Bei 0 erscheint der Befehl nur im Menü, bei 1 zusätzlich auf der Toolbar.

`Hint`

Die Kurzhilfe wird eingeblendet, wenn die Maus auf dem Menüeintrag oder dem Toolbar-Symbol ruht. Das Programm kann zwischen einer Maus- und Statusleisten-Version unterscheiden. Geben Sie entweder nur einen Hilfetext ein oder trennen Sie die beide Versionen mit dem |-Zeichen:
Erscheint an der Maus|Steht in der Statusbar

`HelpContext`

Nummer der zugeordneten Direkthilfe. In der Regel geben Sie 0 ein, keine Direkthilfe.

`MacroCmd`

Das OmAPI-Makro, welches bei Auswahl des Befehls ausgeführt wird. Mit Hilfe der Makrofunktion ScriptControl können auch Visual Basic-Skripte und JScript aufgerufen werden.

Häufige Fehler

Die Meldung "Komponente mit dem Namen "usr..." existiert bereits" bedeutet, dass zwei Sektionen mit demselben Namen vorhanden sind. Benennen Sie eine bitte um.
Fehler "Listenindex überschreitet das Maximum" beim Programmstart: die angegebene Position ist zu groß.

Beispiel

Beispieldatei usermenu.ini mit folgenden benutzerdefinierten Befehlen:

usrMHelpSubWebOpenFAQ: öffnet eine Internetseite,
usrMSearchPathG: sucht im Dokumentenarchiv,
usrMFileOpenTestPDF: öffnet eine PDF-Datei, wenn diese vorhanden ist,
usrMFileVBHelloWorld: "Hello Word" als VBScript.

Hinweise

Der Office Manager liest die usermenu.ini beim Programmstart ein, nach Änderungen ist also ein Neustart erforderlich.
Falls Sie den ScanSnap-Assistenten ausgeführt haben, dann ist die INI bereits vorhanden und beinhaltet einen Befehl zum Öffnen des Scanner-Handbuchs.