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
- Markieren Sie auf einer Seite, was erhalten bleiben soll: Bauteile, Leiter, Texte, Bilder — alles Markierbare geht.
- Rechtsklick auf die Auswahl → „Vorlage erstellen“. Der Eintrag erscheint nur bei vorhandener Auswahl; ein Rechtsklick ins Leere liefert das Seitenmenü.
- 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.
- 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
Getting Started
🌐 Languages — English · Français · Deutsch
Guides
Conductors — wire properties, what feeds which export, and cables
Wire & cable catalogue — cable types, IEC 60757 core colours, assigning a core to a conductor
Printing and exporting — paper, PDF, images, and what each path does differently
Linking elements — master, slave, terminal
PLC modules — I/O tables and linking a wire to a specific point
Using the element editor — drawing tools, saving, checks
Preferences reference — what each settings page does
Keyboard-only control — mouseless QET, and the one real gap
Mouse modifiers — what Shift, Ctrl and Alt change while you drag
Managing collections — folders, writability, building your own shortlist
Templates — reusable multi-element blocks, and why clicking one does nothing
Search & Replace — bulk property changes
Building a nomenclature query — the BOM/summary table builder
Linking wires across pages — folio reports
Variables & formulas — %f, %{label}, sequences
Auto-numbering — schemes, sequences, freezing
Terminal strips — strips, levels, bridges
Title block templates — the .titleblock format
Importing EPLAN parts (.edz) — EPLAN Data Portal
DXF import & export — two unrelated features, one format
The project database — the in-memory SQLite cache
Development
Automating QET — CLI, XML formats, external tools
CLI Reference — command line usage
JavaScript Scripting — --run, geometry editing, undo
Vision — proposal, under discussion
