This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Benutzerhandbuch

Komplette Referenzbeschreibung für die Verwendung von QElectroTech zum Erstellen von Stromlaufplänen, Schaltplänen und Automatisierungszeichnungen.

Grundlagen

QElectroTech starten

Linux/macOS/Windows:

Doppelklicken Sie auf die QElectroTech-Anwendung
Oder starten Sie vom Terminal: qelectrotech

Plattformspezifisch:

Linux: Auch über Paketmanager verfügbar (apt install qelectrotech)
macOS: Ziehen Sie die Anwendung vom Anwendungsordner zum Dock für schnellen Zugriff
Windows: Heften Sie ans Startmenü oder Desktop an für schnellen Start

Anwendung beenden

Datei → Beenden (oder Datei → Beenden)
Schließen Sie das Hauptfenster
Speichern Sie Ihre Projekte vor dem Beenden

Hilfe in QET erhalten

Hilfe → Handbuch — Öffnet das offizielle PDF-Handbuch
Hilfe → Über — Zeigt Version und Credits
Rechtsklick auf Elemente für Kontexthilfe

Benutzeroberfläche

Hauptarbeitsbereich

┌─────────────────────────────────────────────────────────┐
│ Menüleiste (Datei, Bearbeitung, Ansicht, Einfügen, Werkzeuge, Hilfe)      │
├─────────────────────────────────────────────────────────┤
│  Symbolleiste (Auswahl, Draht, Text, Formen, etc.)           │
├─────────┬─────────────────────────────┬─────────────────┤
│ Projekt │                             │  Elementenpanel │
│ Panel   │   DIAGRAMM-LEINWAND         │  (Suche & Durchsuchen)
│         │   (Ihr Zeichenbereich)      │                 │
│ (Folios)│                             │  Eigenschaften  │
│         │                             │  (Markiertes Element)│
├─────────┴─────────────────────────────┴─────────────────┤
│ Statusleiste (Koordinaten, Zoom, Aktueller Modus)          │
└─────────────────────────────────────────────────────────┘

Wichtigste Panels

Elementenpanel (rechte Seite)

Suchfeld zum Suchen von Komponenten
Kategorien zum Durchsuchen
Ziehen Sie Elemente auf die Leinwand
Zeigt "Master"-Elemente und Verbindungsinformationen

Projektpanel (linke Seite)

Listet alle Folios (Seiten) in Ihrem Projekt auf
Neue Folios hinzufügen (Diagramme)
Folios organisieren und umbenennen
Rechtsklick für Folio-Eigenschaften

Symbolleiste

Auswahlwerkzeug — Objekte auswählen und verschieben
Draht-Werkzeug — Elektrische Verbindungen zeichnen
Text-Werkzeug — Beschriftungen und Anmerkungen hinzufügen
Form-Werkzeuge — Rechtecke, Kreise, Polygone hinzufügen
Zoom-Steuerelemente — Ansicht vergrößern/verkleinern

Einstellungspanel (Windows-Menü)

Seitenpanels anzeigen/verbergen nach Bedarf
Arbeitsbereich-Layout anpassen
Benutzerdefinierte Arbeitsbereiche speichern

Arbeitsbereich anpassen

Ansicht → Panels — Seitenpanels anzeigen/verbergen
Ansicht → Symbolleisten — Symbolleisten anzeigen/verbergen
Ziehen Sie Panels zum Umpositionieren
Doppelklicken Sie auf Panel-Tabs zum Dockeln/Abdockeln

Projekte und Folios

Neues Projekt erstellen

Datei → Neues Projekt erstellt sofort ein leeres Projekt — es gibt bei diesem Schritt keinen Assistenten und keinen Einstellungsdialog. Das neue Projekt beginnt mit einem leeren Folio, unter Verwendung der geerbten Standard-Rahmen-, Leiter- und Schriftfeldeinstellungen (siehe Projekteigenschaften, um Seitengröße, Ränder und weitere Vorgaben anschließend zu ändern).

Folios verstehen

Ein Folio ist eine einzelne Seite/ein Diagramm in Ihrem Projekt. QET kennt keinen „Folio-Typ", den man beim Anlegen wählt — ein Folio ist ein Folio, und was am Ende darauf zu sehen ist (Übersichtsschaltplan, Stromlaufplan, Steuerlogik …), ergibt sich einzig aus dem, was Sie darauf zeichnen.

Ein neues Folio legen Sie per Rechtsklick im Projektpanel → Folio hinzufügen an. Es entsteht sofort, mit den im Projekt hinterlegten Standardeinstellungen für Rahmen, Leiter und Schriftfeld — auch hier ohne Dialog oder Typauswahl.

Ihr Projekt organisieren

Folios umbenennen: Rechtsklick auf Folio → Umbenennen
Folios neu ordnen: Ziehen und ablegen im Projektpanel
Folios löschen: Rechtsklick → Löschen (bestätigen)
Folio-Eigenschaften: Rechtsklick → Eigenschaften
- Schriftfeldinformationen — siehe Schriftfeldvorlagen
- Autor, Datum und weitere Schriftfeldfelder

Projekte öffnen und speichern

Öffnen:

Datei → Zuletzt geöffnet — Schneller Zugriff auf zuletzt verwendete Projekte
Datei → Öffnen — Nach .qet-Dateien durchsuchen
Strg+O (oder Cmd+O) — Tastaturkürzel

Speichern:

Datei → Speichern — Aktuelles Projekt speichern (Strg+S)
Datei → Speichern unter — Mit neuem Namen speichern
QET schreibt im Hintergrund regelmäßig eine Absicherungskopie (kein einstellbares „automatisches Speichern" — es gibt keine Einstellung für dessen Intervall). Beendet sich QET unerwartet, bietet es beim nächsten Öffnen des Projekts an, diese Kopie wiederherzustellen.

Dateiformat:

QElectroTech-Projekte werden als .qet-Dateien gespeichert
XML-basiertes Format, menschenleserlich
Kann bei Bedarf in Texteditor geöffnet werden

Mit Elementen arbeiten

Elemente finden

Suchmethode:

Geben Sie im Suchfeld oben im Elementenpanel ein
Ergebnisse erscheinen sofort während Sie tippen
Klicken Sie auf Element zum Auswählen für Platzierung

Nach Kategorie durchsuchen:

Erweitern Sie Kategorien im Elementenpanel
Kategorien organisiert nach Typ (Schalter, Relais, etc.)
Unterkategorien für spezifische Komponentenfamilien

Die obersten Kategorien der mitgelieferten Sammlung tragen Namen nach der IEC-artigen Nummerierung — 10_allpole, 20_logic, 30_hydraulic, 50_pneumatic, 60_energy — jede mit mehreren Ebenen von Unterkategorien. Es gibt keine feste kurze Liste, die man sich merken müsste — durchsuchen Sie den Baum oder nutzen Sie das Suchfeld.

Elemente platzieren

Drag & Drop:

Klicken und halten Sie ein Element im Elementenpanel
Ziehen Sie auf Ihre Leinwand
Loslassen zum Platzieren
Element erscheint an Cursor-Position

Mehrfachplatzierung:

Nicht im Elementenpanel loslassen, einfach mehrfach auf die Leinwand klicken
Bequem zum Hinzufügen vieler gleicher Elemente

Nach dem Platzieren drehen:

Element auswählen und Leertaste drücken, um jeweils um 90° zu drehen

Elemente auswählen

Einzelauswahl:

Klicken Sie auf Element mit Auswahlwerkzeug

Mehrfachauswahl:

Halten Sie Strg (oder Cmd auf Mac) und klicken Sie auf Elemente
Oder ziehen Sie ein Auswahlrechteck um mehrere Elemente

Alle auswählen:

Bearbeitung → Alles auswählen (Strg+A)
Oder verwenden Sie Strg+A

Elemente verschieben und positionieren

Verschieben:

Klicken Sie auf Element zum Auswählen (Griffe erscheinen)
Ziehen Sie an neue Position
Halten Sie Umschalt um auf horizontal/vertikal beschränkt zu bleiben

Präzisionspositionierung:

Verwenden Sie Pfeiltasten um markierte Elemente zu schieben
Halten Sie Umschalt für größere Sprünge

An Raster einrasten:

Elemente rasten standardmäßig an Raster ein
Rastereinrasten umschalten: Ansicht → An Raster einrasten
Die Standard-Rastergröße wird auf der Einstellungsseite Allgemein festgelegt — siehe Einstellungsreferenz

Elemente duplizieren

Kopieren und Einfügen:

Wählen Sie Element(e) aus
Strg+C zum Kopieren
Strg+V zum Einfügen (wird versetzt vom Original angezeigt)
Ziehen Sie an endgültige Position

Schnelles Duplizieren:

Wählen Sie Element aus
Bearbeitung → Duplizieren
Neue Kopie erscheint in der Nähe

Drehen

Wählen Sie das oder die Elemente aus und drücken Sie Leertaste, um um 90° zu drehen, oder Rechtsklick → Drehen. Umschalt+Leertaste dreht eine Gruppenauswahl als Ganzes statt elementweise; Strg+Leertaste dreht nur die Beschriftungen/Texte, nicht die Grafik.

Für auf einem Folio platzierte Elemente gibt es keine Spiegel-Funktion — ein Symbol spiegelt man einmalig im Element-Editor, indem man das Symbol selbst neu zeichnet oder spiegelt.

Elemente löschen

Wählen Sie Element(e) aus
Drücken Sie Entfernen Taste
Oder Rechtsklick → Löschen
Verwenden Sie Strg+Z um Löschen rückgängig zu machen

Drähte und Leiter zeichnen

Leiter verstehen

Ein Leiter ist eine elektrische Verbindung zwischen Elementen (Drähte/Leitungen).

Typen:

Einleiter — Vereinfachte Darstellung
Mehrleiter — Einzelne Leiterleitungen angezeigt

Drähte zeichnen

Basis-Drahtzeichnung:

Klicken Sie auf das Draht-Werkzeug (Blitz-Symbol)
Klicken Sie auf einen Anschluss (Verbindungspunkt auf Element)
Bewegen Sie die Maus zum Zielanschluss
Klicken Sie zum Fertigstellen des Drahtes
Draht wird gezeichnet, automatisch geroutet

Mehrschicht-Drähte:

Klicken Sie auf ersten Anschluss (Startpunkt)
Klicken Sie auf Zwischenpunkte zum Routing
Klicken Sie auf finalen Anschluss (Endpunkt)
Drücken Sie Escape zum Beenden

Draht-Routing:

Automatisches Routing erstellt typischerweise orthogonale (rechtwinklige) Pfade
Klicken Sie auf Wegpunkte um Pfad zu kontrollieren
Drücken Sie Escape um Draht abzubrechen

Drähte bearbeiten

Draht-Pfad ändern:

Wählen Sie Draht aus (klicken Sie darauf)
Ziehen Sie Wegpunkte um Routing anzupassen
Rechtsklick auf Wegpunkt um ihn zu entfernen

Draht löschen:

Wählen Sie Draht aus
Drücken Sie Entfernen

Drähte verbinden sich nur an Anschlüssen — zwei Drähte, die sich auf der Zeichenfläche kreuzen, verbinden sich nicht, es sei denn, sie treffen sich tatsächlich an einem Anschluss.

Draht-Eigenschaften

Draht-Erscheinungsbild ändern:

Rechtsklick auf Draht
Wählen Sie Eigenschaften
Ändern Sie:
- Farbe (aus Farbpalette)
- Stil (durchgezogen, gestrichelt, gepunktet)
- Dicke (Linienbreite)

Leiter-Eigenschaften:

Rechtsklick auf Draht
Wählen Sie Leiter-Eigenschaften
Legen Sie fest:
- Leitertyp (Phase, Neutralleiter, Masse, etc.)
- Elektrische Eigenschaften
- Nummerierungsschema

Text, Beschriftungen und Anmerkungen

Textbeschriftungen hinzufügen

Text-Werkzeug Methode:

Klicken Sie auf Text-Werkzeug (A-Symbol) in der Symbolleiste
Klicken Sie auf Leinwand wo Sie Text wünschen
Geben Sie Ihren Text ein
Klicken Sie anderswo um fertig zu werden

Schnellbeschriftung auf Elementen/Drähten:

Doppelklicken Sie auf Element oder Draht
Geben Sie Text ein (z.B. "S1" für Schalter 1)
Drücken Sie Eingabe
Beschriftung erscheint auf Objekt

Drähte beschriften

Häufige Drahtbeschriftungen:

Signalnamen: "L1", "L2", "N", "PE" (Masse)
Spannung: "24V AC", "12V DC"
Funktion: "Aktivieren", "Zurücksetzen", "Alarm"

Drahtbeschriftung hinzufügen:

Doppelklicken Sie auf Draht
Geben Sie Beschriftungstext ein
Drücken Sie Eingabe

Elemente beschriften

Häufige Element-Beschriftungen:

Referenzbenennung: "S1" (Schalter 1), "R1" (Relais 1), "M1" (Motor 1)
Komponentenwert: "100kΩ", "10µF"
Beschreibung: "Stromschalter", "Startknopf"

Element beschriften:

Doppelklicken Sie auf Element
Geben Sie Referenz ein (z.B. "Q1")
Drücken Sie Eingabe

Dynamische Textfelder

Ein dynamisches Textfeld kann einen lebenden Wert statt festen Textes zeigen — die Beschriftung eines Elements, eine Folionummer, eine Herstellerreferenz und mehr. Das ist eine eigene, vollständige Variablensprache, und an verschiedenen Stellen gelten verschiedene Variablen (eine Elementbeschriftung hat nicht denselben Satz wie ein Foliofeld). Die vollständige Referenz steht unter Variablen und Formeln — es lohnt sich, dort nachzuschlagen, bevor man einen Variablennamen rät: Eine nicht erkannte Variable bleibt stillschweigend als wörtlicher Text stehen, statt als Fehler gemeldet zu werden.

Textformatierung

Schrift und Stil:

Wählen Sie Textelement aus
Rechtsklick → Eigenschaften
Konfigurieren Sie:
- Schriftfamilie (Arial, Times, etc.)
- Größe (Punkte)
- Farbe
- Ausrichtung (horizontal, vertikal, 45°, etc.)

Schema-Bearbeitung und Formatierung

Auswahl und Organisation

Alle Objekte auswählen:

Bearbeitung → Alles auswählen (Strg+A)

Nach Typ auswählen:

Bearbeitung → Auswählen (Untermenü zum Auswählen spezifischer Typen)

Mehrfach-Auswahl-Tipps:

Halten Sie Strg und klicken um zur Auswahl hinzuzufügen
Umschalt+Klick um Bereich auszuwählen
Ziehen Sie Feld um alle darin auszuwählen

Ausrichtung und Verteilung

Objekte ausrichten:

Wählen Sie mehrere Objekte aus
Rechtsklick → Ausrichten
Wählen Sie: Links, Rechts, Oben, Unten, Mitte

Abstände verteilen:

Wählen Sie Objekte aus (3 oder mehr)
Rechtsklick → Verteilen
Gleichmäßig horizontal oder vertikal abstande

Raster- und Einrastfunktionen

Rastereinstellungen:

Ansicht → An Raster einrasten — Einrasten an/aus umschalten
Einstellungen → Raster — Rastergröße anpassen
Kleineres Raster = feinere Positionierung; größer = schnellere Platzierung

Ausrichtungs-Tipps:

Einrasten für ordentliche, ausgerichtete Diagramme
Deaktivieren für freie Platzierung
Mit Tastaturkürzel umschalten

Rückgängig und Wiederherstellen

Rückgängig:

Strg+Z (oder Cmd+Z auf Mac)
Bearbeitung → Rückgängig aus Menü
Mehrere Schritte wiederholt rückgängig machen

Wiederherstellen:

Strg+Y (oder Cmd+Umschalt+Z auf Mac)
Bearbeitung → Wiederherstellen aus Menü
Mehrere Schritte wiederholt wiederherstellen

Zoom und Schwenken

Zoom-Methoden:

Scroll-Rad: Oben zum Vergrößern, unten zum Verkleinern
+/- Tasten: Vergrößern oder verkleinern
Strg+Scroll: Feinkontroll Zoom
Ansicht → Zoom → An Seite anpassen: Diagramm automatisch anpassen

Schwenken (Ansicht verschieben):

Mittlere Maustaste: Klicken und ziehen zum Schwenken
Leertaste + Ziehen: Leertaste halten und ziehen zum Schwenken
Pfeiltasten: Ansicht schieben (wenn nichts ausgewählt)

Berichte und Dokumentation

Berichte generieren

Ein eigenes „Berichte"-Menü gibt es nicht: Eine Stückliste oder eine Verdrahtungsliste entsteht über Datei → Export, oder ohne Oberfläche über die Kommandozeile (--export-bom, --export-wiring, --export-nets, --export-links). Die vollständige Liste steht unter QElectroTech automatisieren, was jede davon tatsächlich abfragt, unter Die Projektdatenbank.

Export und Druck

Diagramme drucken

Datei → Drucken (Strg+P) öffnet zuerst den systemeigenen Druckdialog, um einen Drucker zu wählen (Papiergröße, Duplex, Farbe oder Graustufen — was auch immer der Treiber bietet; das sind keine QET-Einstellungen). Die Bestätigung dort öffnet ein Druckfenster mit Live-Vorschau — dasselbe Fenster wie bei Datei → Als PDF exportieren, das den Systemdialog überspringt und direkt hierher führt. In diesem Fenster wählen Sie, welche Folios einbezogen werden, ob Leiterfarben erhalten bleiben, und richten die Seite über eine eigene Schaltfläche Seite einrichten ein (unter Windows beim PDF-Export deaktiviert). Einen eigenen Menüpunkt „Druckvorschau" gibt es nicht, ebenso wenig eine manuelle Maßstabseinstellung — ein Folio wird automatisch an die Seite angepasst.

Drahtbeschriftungen (Leiter) sind gewöhnlicher Folio-Inhalt, keine eigene Druckfunktion. Sie werden wie jedes andere Element mit dem Folio gedruckt oder exportiert — es gibt keinen eigenen Schalter, um sie ein- oder auszublenden (anders als bei Klemmenmarkierungen, die einen solchen haben — siehe Einstellungsreferenz §3).

QET hat keinen eingebauten Drucker für physische Drahtmarkierungs-/Aderendhülsen-Etiketten. Dafür exportieren Sie die Verdrahtungsliste als CSV (Menü Projekt, oder --export-wiring) und speisen sie in die eigene Software eines Etikettendruckers ein — siehe QElectroTech automatisieren, das den real genutzten Arbeitsablauf (Brady, WAGO, Phoenix Contact) und eine bekannte Einschränkung mit doppelten Zeilen bei größeren Aufträgen behandelt.

Diagramme exportieren

Export-Formate:

PDF — Professionelle Dokumente, beste zum Teilen
PNG — Rasterbild, gut für Web
SVG — Vektorformat, editierbar in anderer Software
DXF — CAD-Format für Zusammenarbeit (nur Umrisse und Text, siehe Grenzen)

Export-Prozess:

Wählen Sie Folio(s) zum Exportieren
Datei → Exportieren
Wählen Sie Format und Speicherort
Konfigurieren Sie Export-Optionen
Klicken Sie auf Exportieren

Einstellungen und Voreinstellungen

Bearbeiten → Einstellungen öffnet fünf Seiten: Allgemein, Neues Projekt, Export, Drucken und Tastenkürzel. Es gibt keine eigene Kategorie „Anzeige" oder „Raster" — beide liegen unter Allgemein. Was jede Seite tatsächlich steuert, steht unter Einstellungsreferenz.

Fortgeschrittene Themen

Benutzerdefinierte Elemente erstellen

Den Element-Editor benutzen behandelt das Zeichnen eines Elements im eingebauten Editor von QET — Werkzeuge, Klemmenplatzierung und die Prüfungen beim Speichern. Elemente verknüpfen behandelt, wie man daraus einen Master, Slave oder eine Klemme macht. Elements XML dokumentiert direkt das resultierende Dateiformat, für alle, die .elmt-Dateien ohne den Editor erzeugen.

Element-Sammlungen und Bibliotheken

Sammlungen verwalten behandelt das Organisieren von Ordnern, das Verschieben und Löschen von Elementen, und welche der drei Sammlungen (gemeinsam/eigen/Firma) sich tatsächlich bearbeiten lässt.

Multi-Benutzer-Workflows

QET hat keine eingebaute Funktion für gemeinsames oder mehrbenutzerfähiges Bearbeiten — eine .qet-Datei wird immer von einer Instanz zur Zeit bearbeitet, wie jedes andere Dokument auch (siehe Die Projektdatenbank: Selbst der Abfrage-Cache im Speicher ist je Prozess, nicht gemeinsam genutzt). Zwei praktische Möglichkeiten, wenn mehrere Personen am selben Projekt arbeiten müssen:

Nach Folio aufteilen. Da ein Projekt aus Folios in einer Datei besteht, vermeidet die Absprache, wer welches Folio betreut, Kollisionen von vornherein.
Versionskontrolle (Git o. Ä.) auf der .qet-Datei. Das funktioniert, wenn man sich abwechselt, doch ein echter Merge-Konflikt ist ein Konflikt in rohem XML, keine strukturierte Zusammenführung von Schaltplänen — ihn zu lösen heißt, das XML von Hand zu bearbeiten oder eine Seite komplett zu übernehmen. Planen Sie mit „eine Person nach der anderen", nicht mit gleichzeitigem Bearbeiten.

Scripting und Automatisierung

QET hat keine eingebettete Skriptsprache. Automatisiert wird von außen:

die Kommandozeile ohne Oberfläche — --export-pdf, --export-bom, --export-wiring und weitere, mit echten Rückgabewerten
direktes Bearbeiten des XML — .qet und .elmt sind gewöhnliches XML

Siehe QElectroTech automatisieren und die Kommandozeilen-Referenz.

Fehlerbehebung

Häufige Probleme

"Element verbindet sich nicht mit Draht"

Klicken Sie direkt auf Anschluss (kleiner Punkt)
Nicht alle Punkte auf Element sind verbindbar
Überprüfen Sie Element-Eigenschaften für Anschluss-Definitionen

"Drähte kreuzen sich ohne Verbindung"

Drähte verbinden sich nur an Anschlüssen
Sich kreuzende Linien verbinden sich nicht automatisch
Verwenden Sie explizite Verbindung an Anschluss-Punkten

"Diagramm ist langsam/Verzögerung"

Große Projekte mit vielen Elementen verlangsamen die Reaktionsfähigkeit
Reduzieren Sie Zoom-Stufe um Leistung zu verbessern
Deaktivieren Sie Rasteranzeige falls nicht nötig
Schließen Sie unnötige Panels

"Datei lässt sich nicht öffnen"

Beschädigte Datei oder Kompatibilitätsproblem
Versuchen Sie in Texteditor zu öffnen um XML-Gültigkeit zu überprüfen
Wiederherstellen aus Sicherung falls verfügbar

Tastaturkürzel

Aktion	Windows/Linux	macOS
Neu	Strg+N	Cmd+N
Öffnen	Strg+O	Cmd+O
Speichern	Strg+S	Cmd+S
Drucken	Strg+P	Cmd+P
Rückgängig	Strg+Z	Cmd+Z
Wiederherstellen	Strg+Y	Cmd+Umschalt+Z
Alles auswählen	Strg+A	Cmd+A
Kopieren	Strg+C	Cmd+C
Einfügen	Strg+V	Cmd+V
Löschen	Entfernen	Entfernen
Auswahl drehen	Leertaste	Leertaste
Gruppe als Ganzes drehen	Umschalt+Leertaste	Umschalt+Leertaste
Vergrößern	Strg++	Cmd++
Verkleinern	Strg+-	Cmd+-
An Seite anpassen	Strg+9	Cmd+9