Skip to main content

Sektion: MetaData

Die Sektion MetaData enthält die Beschreibung des Moduls, die Kategorie und die Icons (der Größe 16x16 Pixel und 32x32 Pixel).

SEC MetaData                                                                                                                                                                                                                                        //optional: yes, modifier: [UPDATE]]
    Desc := <description>;                   //optional: no, type: text
    Category := <category name>;             //optional: no, type: CategoryPath
    Icon_16 := <icon16 name>;                //optional: no, type: image
    Icon_32 := <icon32 name>;                //optional: no, type: image
    Inst_Prefix := <instance prefix>;        //optional: yes, type: IDOrNothing
    Default_Inst_Name := <instance name>;    //optional: yes, type: text
    Links := ['<link1>','<link2>',...]       //optional: Yes, type: UriCollection
END_SEC

Details über die Syntax der Definitionstypen sind im Kapitel Syntax der Moduldeklaration beschrieben.

. Spezifikation:

  • Wenn der der Abschnitt MetaData fehlt, dann wird das Modul als nicht-instanziierbares Basismodul behandelt.

  • Category definiert einen Überbegriff für Module eines Themenbereichs. Das Zeichen | erzeugt eine hierarchische Struktur im Moduldialog. Die Zeichen | und Newline oder Carriage-Return dürfen im Strukturnamen nicht enthalten sein.

  • Icon_16 definiert den Namen des Icons mit einer Auflösung von 16 x 16 Pixel. Die Bilddateien für die Icons werden in einer Bildersammlung definiert. Das Icon Icon_16 wird für den Modulbaum verwendet und das Icon Icon_32 für den Informationsdialog.

  • Inst_Prefix ist das Default-Präfix, das für die Namen der generierten FB-Instanzvariablen von Submodul-Instanzen verwendet wird. Es sind auch leere Prefixe (Inst_Prefix := ) möglich, für die jedoch keine Überschneidungsfreiheit mit anderen Variablennamen des FBs garantiert werden kann. Die Voreinstellungen können in der Sektion Slot überschrieben werden.

  • Wenn mit IMPORTS von einer Moduldeklaration ableitet wird, dann muss der Abschnitt MetaData aktualisiert werden, sofern das Basismodul einen solchen Abschnitt mitbringt. Dazu muss der Abschnitt mit dem Modifier UPDATE deklariert werden und zumindest Name und Beschreibung neu gesetzt werden.

  • Default_Inst_Name dient dazu einen Default-Namen für Modulinstanzen unter diesem Slot anzugeben. Jedes Modul, das hinzugefügt wird, bekommt standardmäßig den Instanznamen der hier (über eine evtl. mehrsprachige Textliste) angegeben werden kann. Wenn ein Eltern-Slot einen Default-Namen hat, wird dieser dem Default-Namen in Metadata bevorzugt.

  • Links definiert eine Liste von Links. Die Links werden im Moduleditor auf der Registerkarte Information dargestellt. Der Inhalt der ersten URL dieser Liste wird in der Registerkarte Information dargestellt.

Beispiel 16. Beispiel
SEC MetaData
        Desc := TL.Desc_Drives ;
        Category := 'Mechatronics'|'Drives' ;
        Icon_16 := IP.Drive_Icon_16 ;
        Icon_32 := IP.Drive_Icon_32 ;
        Default_Inst_Name := IDrive ;
        Links := ['file:///d:\Document1.pdf', 'https://www.codesys.com', 'mailto:info@codesys.com'];
END_SEC

Category := 'Mechatronics'|'Drives erzeugt die folgende Struktur:

ac_CollectionCategory.png


In diesem Abschnitt: