templates DE

Vorlagen (das Register „Vorlagen“)

Eine Vorlage — im Menü template, im Code und auf der Festplatte Makro (.qetmak) — ist ein gespeichertes Stück Seite: die Bauteile, die Sie markiert hatten, mitsamt ihren eigenen Symboldefinitionen in derselben Datei. Sie lässt sich auf jeder Seite und in jedem Projekt als Block wieder absetzen.

Das ist das richtige Werkzeug für den Verdrahtungsblock, den Sie immer wieder zeichnen: einen Motorabgang, einen Beleuchtungsstromkreis, eine Standardeinspeisung. Ein Bauteil ist ein Symbol; eine Vorlage ist eine Anordnung davon.

Eine Vorlage wird ausschließlich per Ziehen und Ablegen abgesetzt. Ihren Namen in der Liste anzuklicken oder doppelt anzuklicken bewirkt gar nichts — absichtlich, im Code — und ihr Kontextmenü hat keinen Eintrag zum Einfügen. Wenn Sie eine Vorlage ausgewählt und darauf gewartet haben, dass etwas geschieht: nichts war kaputt. Ziehen Sie sie auf die Seite. Das ist mit Abstand das häufigste Missverständnis zu dieser Funktion.

Sprachhinweis. Auf Deutsch heißen sowohl das Register als auch die Sammlung darin Vorlagen — im Französischen tragen sie zwei verschiedene Namen.

Quellen: sources/diagramview.cpp, sources/ElementsCollection/elementscollectionwidget.cpp, sources/diagramevent/diagrameventaddmacro.cpp, lang/qet_de.ts.

---

1. Eine Vorlage erstellen

1. Markieren Sie auf einer Seite, was erhalten bleiben soll: Bauteile, Leiter, Texte, Bilder — alles Markierbare geht.
2. Rechtsklick auf die Auswahl → „Vorlage erstellen“. Der Eintrag erscheint nur bei vorhandener Auswahl; ein Rechtsklick ins Leere liefert das Seitenmenü.
3. Das Fenster „Vorlage speichern“ fragt nach dem Ort. Wählen Sie die Sammlung im Baum, tragen Sie einen „Name der neuen Vorlage“ ein und bestätigen Sie mit Save.
4. Eine Meldung nennt den vollständigen Pfad der geschriebenen Datei.

Die Endung .qetmak wird angehängt — und im Panel wieder ausgeblendet.

---

2. Eine Vorlage absetzen

Öffnen Sie das Register Vorlagen des Bauteil-Panels (neben Sammlungen) und ziehen Sie die Vorlage auf die Seite.

Schritt	Was geschieht
Sie lassen sie auf der Seite los	eine halbtransparente Vorschau der ganzen Vorlage folgt dem Zeiger, am Raster ausgerichtet
Linksklick	die Vorlage wird an der Stelle der Vorschau abgesetzt
Rechtsklick	bricht ab, nichts wird eingefügt
Esc	bricht ebenfalls ab, und zwar ab dem Loslassen

Während des Absetzens ist das Kontextmenü der Seite abgeschaltet; deshalb bricht der Rechtsklick ab, statt ein Menü zu öffnen.

Was eine Vorlage nicht absetzt, von Haus aus:

Aktion	Ergebnis
Einfacher Klick auf den Namen	markiert die Zeile, sonst nichts
Doppelklick auf den Namen	nichts — der Code steigt sofort aus
Kontextmenü der Vorlage	bietet Löschen an, nie Einfügen

---

3. Wo Vorlagen liegen

	Pfad
Standard	(Anwendungsdatenordner)/macros/
Linux	~/.local/share/QElectroTech/QElectroTech/macros/
Windows	%APPDATA%\QElectroTech\QElectroTech\macros\
macOS	~/Library/Application Support/QElectroTech/QElectroTech/macros/

Grundlage ist Qts Ort für Anwendungsdaten; eine portable oder gekapselte Installation (Snap, Flatpak, AppImage mit eigenem Benutzerordner) löst ihn innerhalb dieser Kapsel auf.

Den Ordner können Sie verlegen — etwa auf eine Netzfreigabe, damit ein Team aus derselben Bibliothek arbeitet — unter Einstellungen → Allgemein. Existiert der eingestellte Pfad nicht mehr, fällt QElectroTech auf den Standardordner zurück: Sie sehen eine leere Liste statt einer Fehlermeldung.

Jede Vorlage ist eine Datei. Eine .qetmak in den Ordner zu kopieren lässt sie erscheinen, sie zu löschen entfernt sie; Unterordner sind möglich.

---

4. Was in einer .qetmak steht

XML — und die Symboldefinitionen reisen mit. Genau das macht eine Vorlage zwischen Projekten und Rechnern übertragbar: das empfangende Projekt muss die Bauteile nicht bereits installiert haben.

<qet_macro>
    <collection>
        <element path="import/lampe_pe.elmt">
            <definition height="50" hotspot_x="15" hotspot_y="25" ...>
                ...die vollständige Symbolzeichnung...
            </definition>
        </element>
    </collection>
    <diagram_content>
        <diagram projectId="0" ...>
            <elements>
                ...was Sie markiert hatten...
            </elements>
        </diagram>
    </diagram_content>
</qet_macro>

Teil	Inhalt
<collection>	ein <element> je verschiedenem Symbol, mit vollständiger Definition — eine Vorlage mit sechs gleichen Relais speichert das Relais einmal
<diagram_content>	der markierte Inhalt selbst, als Seitenfragment
die type-Attribute	zu macro://… umgeschrieben, damit die abgesetzten Objekte auf die mitgelieferten Definitionen zeigen

Eine Vorlage mit einer einzigen Lampe ist rund 3 kB groß, fast ausschließlich Symboldefinition.

---

5. Grenzen

• Ziehen und Ablegen ist der einzige Weg. Kein Menüeintrag, keine Tastenkombination, kein Doppelklick — Issue #931.
• Vorlagen lassen sich nicht an Ort und Stelle bearbeiten. Neu erstellen aus einer korrigierten Auswahl.
• Keine Miniaturansicht im Panel — Vorlagen stehen nur mit Namen da, der Name ist also der einzige Hinweis auf den Inhalt — Issue #932.
• Bei Entwicklungsversionen vor dem 13. September 2026 bewirkt das Ziehen einer Vorlage unter Qt 6 nichts; behoben durch PR #853. Aktualisieren, bevor Sie die Funktion für defekt halten.

---

6. Wenn etwas nicht klappt

„Ich wähle meine Vorlage aus und es landet nichts auf der Seite.“ So ist es vorgesehen: Auswählen tut nichts. Ziehen Sie sie auf die Seite.

„Ich habe gezogen und es passiert trotzdem nichts.“ Prüfen Sie das Versionsdatum — siehe den Qt-6-Hinweis oben. Prüfen Sie dann, ob Sie innerhalb der Zeichenfläche losgelassen haben und nicht im grauen Rand.

„Die Vorschau klebt am Zeiger.“ Ein Absetzen läuft: Linksklick setzt ab, Esc oder Rechtsklick bricht ab.

„Meine Vorlagen sind verschwunden.“ Der Vorlagenordner ist unter Einstellungen → Allgemein einstellbar. Zeigt er auf ein nicht eingehängtes Laufwerk, erscheint die Sammlung leer. Pfad prüfen oder die .qetmak-Dateien in den Standardordner kopieren.

---

Siehe auch

• Sammlungen verwalten — das Panel mit dem Register
• Den Bauteil-Editor benutzen — für die Symbole, aus denen eine Vorlage zusammengesetzt wird
• Einstellungen — wo der Vorlagenordner festgelegt wird