Skip to content
ispyisail edited this page Sep 11, 2026 · 1 revision

Utiliser l'éditeur d'élément

Lier des éléments documente le fichier .elmt qui résulte de la création d'un élément — maître/esclave/borne, groupes de contacts, indicateurs d'information. Cette page documente l'autre moitié : dessiner réellement un élément dans l'éditeur intégré de QET.

Source : sources/editor/ (~22 900 lignes) — qetelementeditor.cpp (la fenêtre), elementscene.cpp (le plan de travail), graphicspart/ (une classe par primitive dessinable), esevent/ (les outils de placement interactifs), ui/ (les panneaux de propriétés).


1. Démarrer un élément

Nouvel élément ouvre un assistant en trois étapes :

  1. Catégorie parente — où, dans l'arborescence de la collection, l'élément vivra.
  2. Nom de fichier — l'extension *.elmt est ajoutée automatiquement si vous l'omettez.
  3. Nom(s) — le nom d'affichage de l'élément, un par langue ; seule votre langue d'interface actuelle est requise, les autres peuvent être renseignées plus tard.

L'éditeur s'ouvre sur un plan de travail vide. Il n'y a pas d'étape distincte « définir la taille de l'élément » — voir §3.

Vous pouvez aussi ouvrir un élément existant pour le modifier, ou partir d'un fichier DXF importé comme tracé dans un nouvel élément via Fichier → Importer un fichier DXF — une façon de calquer une géométrie CAO plutôt que de dessiner à partir de rien.


2. Les outils de dessin

Un bouton de barre d'outils par type de primitive :

Outil Dessine
Ligne un segment droit
Rectangle cliquez-glissez un coin à l'autre
Ellipse cliquez-glissez une boîte englobante
Polygone cliquez chaque sommet ; double-clic pour terminer, clic droit pour annuler le dernier point
Arc un arc de cercle
Texte une étiquette fixe, non modifiable une fois placée sur un folio
Champ texte dynamique un texte qui peut être modifié par instance sur un folio — c'est à lui que s'accrochent les informations d'élément et les variables de formule, voir Variables et formules
Borne un point de connexion

Placer des bornes

Une borne a besoin d'une orientation — de quel côté du corps elle sort, et donc de quelle direction un fil peut l'approcher. Pendant le placement, appuyez sur Espace pour la faire pivoter parmi les quatre directions cardinales avant de cliquer pour valider.

Une fois une borne posée, l'outil en démarre immédiatement une autre avec la même orientation — pratique pour une rangée de broches orientées de la même façon. Le clic droit termine l'outil.

Le type et la fonction de la borne (générique, fusible, diode, terre…) se règlent ensuite dans ses propres propriétés, pas au moment du placement — voir Lier des éléments §4.


3. Largeur, hauteur et point d'accroche sont calculés, pas saisis

Il n'existe aucun dialogue où saisir la largeur, la hauteur ou le point d'accroche de l'élément. Ils sont calculés automatiquement à partir de ce que vous avez dessiné, et recalculés à chaque enregistrement :

  • Le rectangle englobant de toutes les primitives du plan de travail est mesuré.
  • Largeur et hauteur sont arrondies vers le haut au multiple de 10 supérieur — avec une particularité : si le reste dépasse 6, un dizaine supplémentaire est ajoutée. Un dessin de 42 px de large devient 50 (c'est exactement l'exemple d'arrondi utilisé par Elements XML — vous savez maintenant d'où vient ce chiffre).
  • Le point d'accroche est placé au centre de ce rectangle englobant arrondi.

Le piège : dessiner loin de l'origine de la scène déplace vos parties

Si votre dessin ne chevauche pas le point d'origine de la scène (0,0), QET recentre toutes les primitives à l'enregistrement pour qu'il le fasse — les parties se déplacent réellement sur le plan de travail, pas seulement dans les coordonnées enregistrées. Dessinez confortablement près du réticule au centre du plan de travail et cela ne vous surprendra jamais ; dessinez loin sur un côté et un enregistrement peut visiblement tout décaler.


4. Enregistrer

Trois actions proches, faciles à confondre :

Action Destination
Enregistrer là d'où l'élément a été ouvert — un emplacement de collection s'il a été ouvert depuis le panneau des éléments, un simple chemin de fichier s'il a été ouvert par fichier
Enregistrer sous demande un emplacement de collection (catégorie + nom), la façon normale d'enregistrer un nouvel élément dans votre collection personnelle
Enregistrer sous (fichier) demande un chemin de système de fichiers ordinaire, hors de toute collection

Les trois exécutent d'abord la même validation (§5) ; un contrôle échoué bloque l'enregistrement et aucune des trois n'écrit rien.


5. Ce qui est vérifié avant l'enregistrement

QET valide l'élément et signale les problèmes comme un avertissement (l'enregistrement continue) ou une erreur (l'enregistrement est bloqué) :

Condition Gravité
Aucune borne du tout avertissement — sauf si l'élément est un renvoi de folio, une définition de conducteur ou une vignette, qui peuvent légitimement n'en avoir aucune
Un renvoi de folio possède autre chose qu'exactement une borne erreur
Une définition de conducteur possède autre chose qu'exactement une borne erreur

Un élément sans aucune borne s'enregistre quand même — vous obtenez simplement un dialogue indiquant qu'il ne pourra être relié à rien, ce qui est parfois exactement ce que vous voulez (une vignette, un bloc de texte, une décoration de cartouche).


6. Au-delà des bases

  • Tables API maîtres. Régler le type d'un élément maître sur API remplace les réglages habituels de budget de contacts par une table d'E-S interactive — voir Lier des éléments §5. Aucun élément de la collection livrée n'utilise actuellement cette fonction.
  • Le style de ligne (épaisseur, couleur, motif de tirets) se règle par primitive depuis son propre panneau de propriétés, pas depuis la barre d'outils.
  • Grille et accrochage fonctionnent comme dans l'éditeur de folio.

Voir aussi : Lier des éléments · Elements XML · Import et export DXF · Variables et formules

Getting Started

Home

🌐 Languages — English · Français · Deutsch

Downloads

Windows without admin rights — the portable archive, no installer

Quick Start Guide

User Manual

FAQ

Tips & Tricks

Guides

Conductors — wire properties, what feeds which export, cables, and hops where wires cross

Wires per terminal — limit the wires on a terminal, chain wiring instead of stars

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

Grid size and element size — why symbols aren't all the same scale, and scaling one without leaving the grid

Preferences reference — what each settings page does

Saving and loading settings — your whole setup in one file, to copy or keep

Keyboard-only control — mouseless QET, and what still needs a mouse

Mouse modifiers — what Shift, Ctrl and Alt change while you drag

3D mouse — SpaceMouse pan, zoom and buttons

Aligning items — snap symbols back to the grid, or line them up

Pictures on a sheet — labels, crop, transparency, what they cost in the file

Arcs and curved wires — the Arc tool, pulling an arc in or out, rounding a corner with a fillet, dashed arcs for lighting layouts

Grouping items — select, move and copy several items as one

Finding your place on a sheet — go to a cell like B13 or 4-B7, keep the headers in sight, show the cell limits, zoom and pan

Showing and hiding kinds of items — hide texts, wire numbers, shapes, pictures, tables or cross-references on every sheet

Drawing faster — place without dragging, the S shortcut bar, command search, gestures

Customising QElectroTech — keys, toolbar size and contents, the gesture ring (partly pending)

Managing collections — folders, writability, building your own shortlist

Templates — reusable multi-element blocks, placed by double-click or drag

Search & Replace — bulk property changes

Building a nomenclature query — the BOM/summary table builder

Linking wires across pages — sheet 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; command-line export and layers

The project database — the in-memory SQLite cache

File formats
Elements XML
Project XML
Development

Building from Source

Contributing Code

Automating QET — CLI, XML formats, external tools

CLI Reference — command line usage

JavaScript Scripting — --run, geometry editing, undo

MCP server — let an AI assistant read, verify and edit projects

Connecting an AI assistant — setup for Claude, Copilot, Gemini, Codex, Cursor, LM Studio

Script buttons — stored scripts with an icon, by hand or by an assistant

Live mode — an assistant working in the open project while you watch

Macro recorder — record a task by hand, for an assistant to script

Development Roadmap

Vision — proposal, under discussion

Developer Tools

About

Features

History

Community

License

Contributing to this Wiki

Clone this wiki locally