Die Methode eines neuen Plugins wird in einer Bibliothekskomponente oder einem Command angelegt.
- Methoden, die in einem Command angelegt sind, werden in der Regel zu einem bestimmten Zeitpunkt vom Projekteur ausgeführt.
- Methoden, die in einer Bibliothekskomponente angelegt sind, werden im Anschluss an das Instanziieren ausgeführt.
Methode in einem Command anlegen
Für das Beispiel wird die Methode im Command Mechatronic.Actions.IncrementValueCommand angelegt. Dieser Name ist während der Registrierung der nativen Java-Methode angegeben worden. Sollte der Name geändert werden, muss der neue Name für die Registrierung angegeben werden (siehe Methode des Plugins registrieren).
So wird das Command erstellt (Die Bibliothek und Unit wird vorausgesetzt):
- Markieren Sie die Unit in der die neue SequenceSelectionAction erstellt werden soll (hier Actions).
- Wählen Sie aus dem Kontextmenü Neu > Objekt....
- Navigieren Sie im Auswahldialog zu Object > Command.
- Bestätigen Sie mit [Fertigstellen].
- Geben Sie einen Namen für das neue Command ein (hier IncrementValueCommand).
- Öffnen Sie die Karteikarte Methoden.
- Fügen Sie mit Hinzufügen eine neue Methode in die Liste der Methoden ein.
- Geben Sie den Namen der Methode an (hier execute, dieser Name ist für die Registrierung der Methode angegeben worden, siehe Methode des Plugins registrieren).
- Wählen Sie den Sprachtyp Nativ.
- Markieren Sie gegebenenfalls die Option Static.
- Fügen Sie die Argumente hinzu, die an die Methode zu übergeben sind und weisen Sie den entsprechenden Typ zu (hier obj mit dem Typ Engineering.Object, dieser Typ ist für die Registrierung angegeben worden, siehe Methode des Plugins registrieren).
SequenceSelectionAction zum Starten des Commands erstellen
Um das neue Command ausführen zu können, ist eine Aktion, beispielsweise eine SequenceSelectionAction nötig. Diese kann aus einem Kontextmenü einer Komponente gestartet werden.
So wird die SequenceSelectionAction erstellt:
- Markieren Sie die Unit in der die neue SequenceSelectionAction erstellt werden soll (hier Actions).
- Wählen Sie aus dem Kontextmenü Neu > Objekt....
- Navigieren Sie im Auswahldialog zu Object > Action > SelectionAction > SequenceSelectionAction.
- Bestätigen Sie mit [Fertigstellen].
- Geben Sie einen Namen für die neue SequenceSelectionAction ein (hier IncrementValueSelectionAction).
- Wählen Sie im Feld Ausgewähltes Objekt die Projektkomponente, die den Parameter length besitzt (hier Station).
- Markieren Sie das Kontrollkästchen Sichtbar in Projekten.
- Geben Sie im Feld Angezeigter Name einen Namen für die SequenceSelectionAction an, der im Kontextmenü der Station angezeigt wird (hier Increment Value).
- Öffnen Sie die Editorseite Methoden.
- Klicken Sie auf .
- Wählen Sie nacheinander die folgenden Commands aus, um sie in die Liste einzufügen:
Object > Command > FrameworkCommand > StartFormulaCacheCommand
Object > Command > IncrementValueCommand
Object > Command > FrameworkCommand > StopFormulaCacheCommand
Object > Command > FrameworkCommand > SaveObjectCommand
- Speichern Sie den Editor.
Anschließend kann die Methode durch den Aufruf von Increment Value aus dem Kontextmenü der Station gestartet werden.