|
<< Click to Display Table of Contents >> RayPack > 8.0 > User Guide > PackDesigner > MSI / MST / RPP-basierte Projekte > Visueller Designer-Modus > Systeminteraktion > Kontextmenü Kontextmenüeintrag hinzufügen |
Um einem Packaging-Projekt ein Kontextmenü hinzuzufügen, wechseln Benutzer in die Kontextmenü-Ansicht des Modus Visual Designer.
Mit einem Klick auf die Schaltfläche Create new... und der Auswahl der Option Create context menu entry wird der Assistent zur Objekterstellung aufgerufen.
Arbeiten Sie sich durch die Schritte des Assistenten, um alle erforderlichen Eigenschaften für das neue Objekt zu definieren.
Jederzeit können Benutzer mithilfe der Schaltflächen Next oder Back, die am unteren Rand des Assistentendialogs angezeigt werden, innerhalb der bereits bearbeiteten Schritte navigieren.
Um den Assistenten zu verlassen, ohne ein neues Objekt zu erstellen, verwenden Sie die Schaltfläche Cancel, die sich ebenfalls am unteren Rand des Assistentendialogs befindet.
Schritt 1: Erweiterung auswählen
Eine der zwingend erforderlichen Eigenschaften eines Kontextmenüeintrags ist die Dateierweiterung, auf die er angewendet werden soll. Daher kann dieser erste Assistentenschritt nicht übersprungen oder ohne ein gültiges Dateierweiterungsobjekt erfolgreich abgeschlossen werden. Die Kombination aus Dateierweiterung und Verb muss innerhalb eines Packaging-Projekts eindeutig sein. Es ist daher möglich, mehrere Kontextmenüeinträge für dasselbe Dateierweiterungsobjekt zu erstellen, aber nicht möglich, einen neuen Kontextmenüeintrag mit derselben Verb- und Dateierweiterungskombination zu erstellen.
Wenn noch keine Dateierweiterungsobjekte vorhanden sind, zeigt dieser Schritt einen Link zum Assistenten zur Erstellung von Dateierweiterungen an. Klicken Sie auf Neue Erweiterung hinzufügen, um den Assistenten aufzurufen und zuerst eine Dateierweiterung vorzubereiten. Sobald der Assistent für Dateierweiterungen abgeschlossen ist, wird die aktuelle Ansicht des Assistenten zur Kontextmenüerstellung aktualisiert. Das neu erstellte Dateierweiterungsobjekt ist bereits als Erweiterung für das Kontextmenü ausgewählt.
Wenn mehr als eine Dateierweiterung im aktuellen Packaging-Projekt gespeichert ist, wird jede Dateierweiterung durch eine separate Kachel dargestellt. Benutzer müssen auf die Kachel der gewünschten Dateierweiterung klicken, um sie zu markieren und dem neuen Kontextmenüobjekt zuzuordnen. Bitte beachten Sie, dass die aktuell ausgewählte Kachel eine andere Hintergrundfarbe hat und ein Häkchensymbol in der oberen rechten Ecke anzeigt.
In diesem Schritt können Benutzer wählen, ob sie ein benutzerdefiniertes Verb manuell definieren oder eines aus dem Standard-Repository auswählen möchten. Die manuelle Option ist standardmäßig aktiv. Um die vordefinierte Option zu aktivieren, klicken Sie auf das Optionsfeld vor der vordefinierten Steuerelementbeschriftung. Sobald eine Option aktiv ist, wird die andere Option deaktiviert.
Jeder Kontextmenüeintrag muss ein Verb haben, daher ist es nicht möglich, ohne eine Auswahl oder manuelle Verbdefinition fortzufahren. Bitte beachten Sie, dass die Kombination aus Dateierweiterung und Verb eindeutig sein muss. Daher ist es nicht möglich fortzufahren, bis eine eindeutige Kombination festgelegt wurde. Bewegen Sie den Mauszeiger über die Eingabesteuerelemente, um den Tooltip mit Hinweisen zur Behebung des Problems anzuzeigen.
Vordefinierte Verben werden automatisch lokalisiert, während manuelle (auch als benutzerdefiniert bezeichnete) Verben nicht spontan lokalisiert werden können.
Intern werden Verben als Textwerte gespeichert und können daher alphanumerische Zeichen und Sonderzeichen enthalten. Aus einer logischen Systemperspektive sind Verben jedoch Befehle, die von der Shell-Erweiterung interpretiert werden, und müssen daher einige grundlegende Formatrichtlinien einhalten:
•Benutzerdefinierte Verben müssen gemäß der Zielanwendung interpretierbar sein
•Verben dürfen keine Sonderzeichen oder Leerzeichen enthalten
Dieser Schritt dient dazu, den Befehl zu definieren, der als Kontextmenüeintrag auf dem Zielrechner angezeigt wird, sowie den Sequenzindex des aktuellen Objekts.
Befehl
Der Befehlstext ist eine lokalisierbare Zeichenkette, die Eigenschaften und andere variable Inhalte des Packaging-Projekts enthalten kann. Wie durch die eckigen Klammern ("[]") auf der rechten Seite des Eingabesteuerelements angegeben, ist die Syntaxvorschlagsfunktion für die Befehlszeichenkette aktiviert. Geben Sie einfach eine öffnende eckige Klammer ("[") ein, um die Vorschlagsfunktion aufzurufen und mögliche Optionen anzuzeigen.
Sequenz
Der Sequenzwert ist eine ganze Zahl, die zur Sortierung der Kontextmenüeinträge pro Dateierweiterung verwendet wird. Die Kontextmenüeinträge werden aufsteigend nach ihrem Sequenzwert sortiert. Der Eintrag mit dem niedrigsten Wert wird automatisch als Standardeintrag definiert.
Befehl und Sequenz können leer gelassen werden. Die Interpretationsergebnisse hängen dann von der Shell-Erweiterung auf dem Zielrechner ab.
Der an den Zielrechner gesendete Befehl kann Argumente enthalten. Das am häufigsten verwendete ist "%1", das den Dateinamen repräsentiert. Ein weiteres, seltener verwendetes Argument ist "%2", das den Namen des für das Zielsystem festgelegten Standarddruckers repräsentiert.
Zusätzliche benutzerdefinierte Parameter können hinzugefügt werden, müssen jedoch sorgfältig behandelt werden: Es ist möglich, Eigenschaften zu verwenden (mit der typischen Notation mit eckigen Klammern, z. B. "[MyProperty]"), jedoch kann die Auflösung tatsächlicher Laufzeitwerte nur dann erfolgreich ausgeführt werden, wenn die Installationssequenz die Eigenschaftsauflösung bereits verarbeitet hat, wenn die Komponente, die den Kontextmenüeintrag enthält, installiert wird.
Wie durch die eckigen Klammern ("[]") auf der rechten Seite des Eingabesteuerelements angegeben, ist die Syntaxvorschlagsfunktion für die Befehlseingabe aktiviert.
Verwenden Sie die Zusammenfassungsseite, um die Korrektheit der in den vorherigen Assistentenschritten definierten Objekteigenschaften zu überprüfen.
•Wenn alle Eigenschaften wie gewünscht eingestellt sind, klicken Sie auf Process, um den Eintrag final zu erstellen.
•Wenn Änderungen erforderlich sind, klicken Sie auf Back, bis der Assistentenschritt mit der fehlerhaften Eigenschaftsdefinition angezeigt wird, und nehmen Sie die erforderlichen Änderungen vor.
Bitte beachten Sie, dass Änderungen in einem frühen Schritt zu anderen Standardwerten oder Optionen in späteren Schritten führen können. Überprüfen Sie daher beim Weiterblättern zur Zusammenfassungsseite, dass alle Schritte die gewünschten Einstellungen enthalten.
Nachdem das neue Kontextmenü erstellt wurde, kann der Assistent durch die Schaltfläche Finish in der unteren rechten Ecke geschlossen werden. Die Kontextmenü-Ansicht wird aktualisiert und die Liste der vorhandenen Objekte enthält den neu erstellten Eintrag, der sichtbar und bearbeitbar ist.