Menüband

Menüband anpassen

In EPLAN gibt es die Möglichkeit, eigene Registerkarten im Menüband, auch Tabs im Ribbon genannt, zu erstellen. Doch was hat das mit Scripting zu tun? Ein Script ist eigentlich eine Erweiterung der Funktionalität eines Buttons in einem Menüband. In einer benutzerdefinierten Registerkarte im Ribbon können vordefinierte Befehle ausgeführt werden. Dies sind alle von EPLAN offiziell unterstützten Actions, welche zudem in der Hilfe dokumentiert sind. Einen Verweis zur Hilfe findest du in Kapitel 5. Diese Befehle werden auch in einem Script verwendet. Ein Vorteil des Scripts gegenüber dem Button im Menüband ist, dass mehrere Actions ausgeführt werden können. In einer Registerkarte müsste man mehrere Schaltflächen erstellen, um zum gleichen Ergebnis zu kommen. Bei der Menge an Möglichkeiten wird der Arbeitsbereich schnell unübersichtlich.

Im Folgenden wollen wir eine neue Registerkarte im Menüband erstellen. Dazu führen wir einen Rechtsklick auf die grafische Oberfläche aus und wählen den Punkt Menüband anpassen... im Kontextmenü aus.

Nun wird uns der Dialog zum Anpassen des Menübands angezeigt. Mit der Checkbox wird dargestellt, ob die Registerkarte sichtbar ist oder nicht.

In sehen wir die unterschiedlichen Steuerelemente, welche wir erstellen oder anpassen können:

Schnellzugriff: Diese Aktionen sind immer sichtbar.
Registerkarten: Zwischen diesen Tabs kann gewechselt werden.
Befehlsgruppe: Einzelne Aktionen können dadurch gruppiert werden.
Befehl: Der Button wird mit Anzeigename (erforderlich) und mit einem Bild (optional) angezeigt.
QuickInfo: Kurze Beschreibung der Aktion (optional)
Beschreibung: Lange Beschreibung der Aktion (optional)

Zusätzlich wird im Menüband das Suchfeld Was möchten Sie tun? angezeigt. In der Suche sind alle Befehle im Menüband durchsuchbar.

Wir erstellen über den Button Neue Registerkarte unsere eigene Registerkarte am Ende der bestehenden Registerkarten. Automatisch wurde auch eine Befehlsgruppe hinzugefügt, denn Befehle können nur in Befehlsgruppen eingefügt werden, nicht direkt in eine Registerkarte.

Über den Button Bearbeiten... vergeben wir den Anzeigenamen Scripting für die Registerkarte. Die gleiche Aktion führen wir für die Befehlsgruppe aus und vergeben den Anzeigenamen Scripte.

Alle Fensterpositionen und das Menüband werden über den sogenannten Arbeitsbereich gespeichert. Hier können wir verschiedene Schemata anlegen. Man findet die Einstellung am rechten oberen Rand des EPLAN-Fensters Arbeitsbereich > Arbeitsbereich bearbeiten.

Befehle hinzufügen

Durch die verschiedenen Arbeitsbereiche können wir je nach Aufgabe das Menüband unseren Bedürfnissen anpassen.

In unserer neuen Befehlsgruppe wollen wir nun drei Befehle hinzufügen:

Script ausführen
Script laden
Script entladen

Diese Befehle finden wir in der Kategorie Weitere Befehle (Datei). Mit dem Button Hinzufügen können wir die Befehle in die Befehlsgruppe einfügen. Diese Befehle findet man über die EPLAN-Oberfläche unter Datei > Extras > Schnittstellen.

Info

Befehle sind abhängig vom Lizenz- und Modulumfang. Ist man z. B. nicht im Besitz des Moduls Revisionsverwaltung, werden die enthaltenen Befehle nicht angezeigt.

Befehle mit Parametern

Nun wollen wir uns ein bisschen steigern und fügen einen weiteren Befehl hinzu und zwar Aktionen > Gerät einfügen in der Befehlsgruppe Test.

Als Anzeigenamen vergeben wir Motorschutzschalter einfügen. Nun schauen wir uns das Textfeld Befehlszeile etwas genauer an. Auf den ersten Blick steht hier ein sehr kryptischer Text mit vielen Zeichen:

XDLInsertDeviceAction /PartNr:? /PartVariant:1

Aufgeteilt wird die Befehlszeile in zwei Bereiche:

Actionname: Der Actionname steht immer am Anfang ohne Sonderzeichen.
Parameter: Für eine Aktion kann es einen oder mehrere Parameter geben. Ein Parameter gibt eine Eigenschaft an, die beschreibt, wie die Action ausgeführt werden soll.

Aufbau der Befehlszeile:

Actionname /Parameter-1:Wert1 /Parameter-2:Wert2 /Parameter-n:Wert-n

Info

Es muss auf die genaue Schreibweise geachtet werden. Bei Parameterwerten mit Leerzeichen muss der Parameterwert in Anführungszeichen (" ") geschrieben werden. Auch die Leerzeichen zwischen den Parametern müssen genau eingehalten werden.

Action XDLInsertDeviceAction:Hinter diesem Text verbirgt sich die Funktion, Geräte in EPLAN einzufügen.
Parameter-1 PartNr: Dieser Parameter ist für EPLAN erforderlich, da bekannt sein muss, welche Artikelnummer eingefügt werden soll.
Parameter-2 PartVariant: Der zweite optionale Parameter gibt an, in welcher Variante der Artikel eingefügt wird (standardmäßig wird dieser Wert auf „1" gesetzt).

Wir suchen uns ein Beispielgerät, in diesem Falle einen Motorschutzschalter, aus der Artikeldatenbank aus. In der EPLAN-Beispieldatenbank finden wir die Artikelnummer SIE.3RV2011-1EA25-0BA0.

XDLInsertDeviceAction /PartNr:"SIE.3RV2011-1EA25-0BA0" /PartVariant:1

Beim Bild wählen wir das M aus. Als QuickInfo hinterlegen wir Motorschutzschalter, und für die Beschreibung wählen wir den zulässigen Strombereich.

Nach Betätigen des Befehls im Menüband ist unser eingestellter Motorschutzschalter im grafischen Editor am Cursor angeheftet und kann nun platziert werden.

Wurde eine Artikelnummer angegeben, die nicht existiert, erscheint eine entsprechende Hinweismeldung.