Mit ActiveView können Sie das Menü Objekt hinzufügen überschreiben. Auf diese Weise können Entwickler Menüeinträge oder Verknüpfungsschaltflächen neben dem Menü hinzufügen, ändern oder löschen. Das allgemeine Konzept und die Methode zum Überschreiben des Menüs ähnelt denen der Leistenüberschreibungen des Menüs Funktionen und des Hauptmenüs, jedoch mit einer leicht abweichenden Syntax (die Werte für Menütyp lauten additem, changeitem and deleteitem). In den folgenden Beispielen wird die für die Überschreibung des Menüs Objekt hinzufügen erforderliche allgemeine Syntax demonstriert.
Die grundlegende Struktur der XML-Syntax für die Überschreibung des Menüs Objekt hinzufügen sieht wie folgt aus. Sämtliche Anpassungen und Änderungen werden zwischen den <override type="additem">...</override>-Tags angegeben.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<overrides>
<override type="additem">
<!-- Add content here -->
</override>
</overrides>
Sie können eine Überschreibung zum Anpassen des Menüs Objekt hinzufügen wie folgt verwenden
Das Attribut newitem ist ein obligatorisches Argument, mit dem Sie den Namen des Menüobjekts festlegen können.
Beim Attribut newimg handelt es sich um ein obligatorisches Argument, mit dem Sie das durch das Menüobjekt verwendete Bild festlegen können.
Das Attribut neworder ist ein optionales Argument, mit dem Sie die Position festlegen können, an dem das Menüobjekt im Menü angezeigt wird. Sofern nicht angegeben, werden die neuen Menüobjekte oben im Menü angezeigt.
Beim Attribut newurl handelt es sich um ein optionales Argument, mit dem Sie die durch das Menüobjekt verwendete URL festlegen können.
Beim Attribut newsubtype handelt es sich um ein optionales Argument, mit dem Sie den durch das Menüobjekt verwendeten Untertypwert festlegen können. Es muss mindestens eines der Attribute newurl und newsubtype angegeben werden. Wenn newsubtype ohne newurl angegeben wird, wird die standardmäßige Erstellungs-URL für den Untertyp verwendet.
Beim Attribut scope handelt es sich um ein optionales Argument, mit dem Sie angeben können, ob sich der Befehl auf das Menü Objekt hinzufügen und die entsprechenden Verknüpfungssymbole neben dem Menü auswirkt. Das Attribut scope unterstützt die folgenden Optionen: scope="icon" (gilt nur für das Verknüpfungssymbol), scope="menu" (gilt nur für das Menüobjekt), scope="both" (gilt für das Verknüpfungssymbol und das Menüobjekt). Wenn „scope“ nicht definiert wurde, wird der Befehl standardmäßig nur auf das Menü angewendet.
Beim Attribut newiconimg handelt es sich um ein optionales Argument. Dieses kann zusammen mit dem Attribut scope verwendet werden. Dies funktioniert identisch wie das Attribut newimg. Der Unterschied besteht darin, dass dieses Attribut Ihnen ermöglicht, eine andere GIF-Datei für das Verknüpfungssymbol anzugeben.
Beim Attribut newiconorder handelt es sich um ein optionales Argument. Dieses kann zusammen mit dem Attribut scope verwendet werden. Dies ähnelt dem Attribut neworder. Der Unterschied besteht darin, dass dieses Attribut Ihnen ermöglicht, die Reihenfolge der Verknüpfungssymbolgruppe zu definieren.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<overrides>
<override type="additem">
<commands>
<additem newItem="Google" newOrder="1" newImg="[LL_REPTAG_SUPPORTDIR /]2-guys.gif" newURL="http://www.google.com" />
<additem newItem="QA Server" newOrder="2" newImg="[LL_REPTAG_SUPPORTDIR /]1arrowup.gif" newURL="http://news.bbc.co.uk" />
<additem newItem="Dev Server" newOrder="3" newImg="[LL_REPTAG_SUPPORTDIR /]1arrowdn.gif" newSubType="12345" />
<additem newItem="My WR" newOrder="4" newImg="[LL_REPTAG_SUPPORTDIR /]required.gif" newURL="[LL_REPTAG_$MYWR LLURL:DEFAULTHREF /]" scope="both" newIconImg="[LL_REPTAG_SUPPORTDIR /]spellcheck.gif" newIconOrder="1" />
</commands>
</override>
</overrides>
In diesem Beispiel werden die Objekte Google, QA Server, Dev Server und My WR den Positionen 1, 2, 3 und 4 des Menüs Objekt hinzufügen hinzugefügt. Bilder wurden über das Verzeichnis <support> definiert und die entsprechenden Verknüpfungen (zum Beispiel newURL) wurden angegeben. Dev Server verwendet die standardmäßige Erstellungs-URL für den Untertyp 12345. Alle standardmäßigen Menüobjekte werden ab Position 5 angezeigt. „My WR“ fügt ebenfalls die Option zu den Verknüpfungssymbolen neben dem Menü hinzu. Das Verknüpfungssymbol wird auf das Bild festgelegt, das durch newIconImg angegeben wurde, und wird auf der linken Seite der anderen Symbole hinzugefügt, da newIconOrder dem Wert 1 entspricht. Im folgenden Bild wird gezeigt, wie das Menü Objekt hinzufügen mit dieser Überschreibung aussieht.

Das Attribut oldItem ist ein obligatorisches Argument, mit dem Sie den Namen des zu ändernden Menüobjekts angeben können.
Beim Attribut newitem handelt es sich um ein optionales Argument, mit dem Sie einen neuen Namen für das Menüobjekt festlegen können.
Beim Attribut newimg handelt es sich um ein optionales Argument, mit dem Sie ein neues Bild für das Menüobjekt festlegen können.
Beim Attribut neworder handelt es sich um ein optionales Argument, mit dem Sie eine neue Position für das Menüobjekt festlegen können.
Beim Attribut newurl handelt es sich um ein optionales Argument, mit dem Sie eine neue URL für das Menüobjekt festlegen können.
Beim Attribut newsubtype handelt es sich um ein optionales Argument, mit dem Sie einen neuen Untertypwert für das Menüobjekt angeben können. Wenn newsubtype ohne newurl angegeben wird, wird die standardmäßige Erstellungs-URL für den Untertyp verwendet.
Beim Attribut scope handelt es sich um ein optionales Argument, mit dem Sie angeben können, ob sich der Befehl auf das Menü Objekt hinzufügen und die entsprechenden Verknüpfungssymbole neben dem Menü auswirkt. Das Attribut scope unterstützt die folgenden Optionen: scope="icon" (gilt nur für das Verknüpfungssymbol), scope="menu" (gilt nur für das Menüobjekt), scope="both" (gilt für das Verknüpfungssymbol und das Menüobjekt). Wenn „scope“ nicht definiert wurde, wird der Befehl standardmäßig nur auf das Menü angewendet.
Beim Attribut newiconimg handelt es sich um ein optionales Argument. Dieses kann zusammen mit dem Attribut scope verwendet werden. Dies funktioniert identisch wie das Attribut newimg. Der Unterschied besteht darin, dass dieses Attribut Ihnen ermöglicht, eine andere GIF-Datei für das Verknüpfungssymbol anzugeben.
Beim Attribut newiconorder handelt es sich um ein optionales Argument. Dieses kann zusammen mit dem Attribut scope verwendet werden. Dies ähnelt dem Attribut neworder. Der Unterschied besteht darin, dass dieses Attribut Ihnen ermöglicht, die Reihenfolge der Verknüpfungssymbolgruppe zu definieren.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<overrides>
<override type="additem">
<commands>
<changeitem oldItem="Appearance" newOrder="1" newImg="[LL_REPTAG_SUPPORTDIR /]2-guys.gif" />
<changeitem oldItem="LiveReport" newItem="Query Data" newOrder="3" newURL="http://jquery.com/" />
<changeitem oldItem="WebReport" newItem="WEBREPORT" newOrder="4" newSubtype="30303" />
<changeitem oldItem="Workflow Map" newItem="[LL_REPTAG_USERNAME /] - Workflow" newOrder="5" newURL="http://www.opentext.com" />
<changeitem oldItem="Folder" newItem="FolderMod" newOrder="6" newIconImg="[LL_REPTAG_SUPPORTDIR /]required.gif" scope="both" newIconOrder="1" />
</commands>
</override>
</overrides>
In diesem Beispiel wird das Objekt Erscheinungsbild an Position 1 in der Liste verschoben, und das Bild wird geändert. Das LiveReport-Objekt wurde in Abfragedaten umbenannt, hat dieses Objekt an Position 3 verschoben und eine URL bereitgestellt, die ausgeführt wird, wenn das Objekt ausgewählt wird. Das WebReport-Objekt wurde an Position 4 verschoben, umbenannt und sein Untertypwert wurde auf „30303“ festgelegt. Es wurde kein newURL-Argument angegeben, daher wird die standardmäßige Erstellungs-URL für den Untertyp 30303 verwendet. Das Workflow-Diagramm-Objekt wurde an Position 5 verschoben, mithilfe eines WebReport-Tags umbenannt, um den Benutzernamen anzuzeigen, und einer URL zur Ausführung bei der Auswahl. Der Befehl zum Ändern des Ordner-Objekts verwendet die Attribute scope, newIconImg und newIconOrder. Durch diese Änderung wird das Menüobjekt in „FolderMod“ umbenannt. Zudem wird der alternative Text des Verknüpfungssymbols in „FolderMod hinzufügen“ umbenannt. Ferner werden dadurch das Bild und die Reihenfolge des Verknüpfungssymbols geändert, sodass es links neben dem Symbol Dokument hinzufügen angezeigt wird. Im folgenden Bild wird das geänderte Menü Objekt hinzufügen veranschaulicht.

Das Attribut oldItem ist ein obligatorisches Argument, mit dem Sie den Namen des zu löschenden Menüobjekts angeben können.
Beim Attribut scope handelt es sich um ein optionales Argument, mit dem Sie angeben können, ob sich der Befehl auf das Menü Objekt hinzufügen und die entsprechenden Verknüpfungssymbole neben dem Menü auswirkt. Das Attribut scope unterstützt die folgenden Optionen: scope="icon" (gilt nur für das Verknüpfungssymbol), scope="menu" (gilt nur für das Menüobjekt), scope="both" (gilt für das Verknüpfungssymbol und das Menüobjekt). Wenn scope nicht definiert wurde, wird der Befehl standardmäßig nur auf das Menü angewendet.
In diesem Beispiel werden mehrere Objekte aus dem Menü Objekt hinzufügen entfernt.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<overrides>
<override type="additem">
<commands>
<deleteitem oldItem="Appearance" />
<deleteitem oldItem="Channel" />
<deleteitem oldItem="Collection" />
<deleteitem oldItem="Community" />
<deleteitem oldItem="Compound Document" />
<deleteitem oldItem="Custom View" />
<deleteitem oldItem="Form" />
<deleteitem oldItem="Form Template" />
<deleteitem oldItem="Poll" />
<deleteitem oldItem="Prospector" />
<deleteitem oldItem="Shortcut" />
<deleteitem oldItem="Suggestion Box" />
<deleteitem oldItem="Task List" />
<deleteitem oldItem="Text Document" />
<deleteitem oldItem="URL" />
<deleteitem oldItem="Workflow Status" />
<deleteitem oldItem="XML DTD" />
<deleteitem oldItem="Folder" scope="icon" />
</commands>
</override>
</overrides>
|
Hinweis:
| |