Repository navigation
templates FR
Un modèle — template dans les menus, macro dans le code et sur le disque
(.qetmak) — est un morceau de folio enregistré : les éléments que vous aviez
sélectionnés, avec leurs propres définitions de symboles à l'intérieur du
fichier, que vous pouvez redéposer sur n'importe quel folio, dans n'importe quel
projet, d'un seul bloc.
C'est l'outil qui convient au bloc de câblage que vous redessinez sans arrêt : un départ moteur, un circuit d'éclairage, une arrivée type. Un élément est un symbole ; un modèle est un agencement de symboles.
Un modèle se dépose par glisser-déposer, et uniquement ainsi. Cliquer ou double-cliquer son nom dans la liste ne fait rien du tout — volontairement, dans le code — et son menu contextuel n'a pas d'entrée « insérer ». Si vous avez sélectionné un modèle en attendant qu'il se passe quelque chose, rien n'était cassé : faites-le glisser sur le folio. C'est de loin la confusion la plus fréquente à propos de cette fonction.
Sources : sources/diagramview.cpp,
sources/ElementsCollection/elementscollectionwidget.cpp,
sources/diagramevent/diagrameventaddmacro.cpp.
- Sur un folio, sélectionnez ce que vous voulez conserver : éléments, conducteurs, textes, images — tout ce qui se sélectionne convient.
- Clic droit sur la sélection → « Créer un template ». L'entrée n'apparaît que si quelque chose est sélectionné ; un clic droit dans le vide donne le menu du folio (propriétés, ajouter ou enlever une ligne ou une colonne).
- La fenêtre « Enregistrer un template » demande où le mettre : « Choisissez l'emplacement dans lequel vous souhaitez enregistrer votre template. » Choisissez la collection dans l'arbre, saisissez un « Nom du nouveau template », puis Save.
- Un message confirme le chemin complet du fichier écrit.
L'extension .qetmak est ajoutée pour vous, et masquée de nouveau quand le
modèle apparaît dans le panneau.
L'onglet s'appelle Modèles mais la collection qu'il contient s'appelle Macros — c'est la même chose. C'est le dossier des modèles décrit plus bas.
Ouvrez l'onglet Modèles du panneau des éléments (à côté de Collections), puis faites glisser le modèle sur le folio.
| Étape | Ce qui se passe |
|---|---|
| Vous le lâchez sur le folio | un aperçu translucide du modèle entier suit le pointeur, aligné sur la grille |
| Clic gauche | le modèle est posé à l'endroit de l'aperçu |
| Clic droit | la pose est annulée, rien n'est ajouté |
| Échap | annule aussi, dès le lâcher et pas seulement après le premier clic |
Pendant une pose, le menu contextuel du folio est désactivé : c'est pourquoi le clic droit annule au lieu d'ouvrir un menu.
Ce qui ne dépose pas un modèle, par conception :
| Action | Résultat |
|---|---|
| Simple clic sur le nom | sélectionne la ligne, rien de plus |
| Double-clic sur le nom | rien — le code sort immédiatement |
| Menu contextuel du modèle | propose la suppression, jamais l'insertion |
Les modèles ont leur propre collection, distincte des éléments :
| Chemin | |
|---|---|
| Par défaut |
(dossier de données de l'application)/macros/
|
| Linux | ~/.local/share/QElectroTech/QElectroTech/macros/ |
| Windows | %APPDATA%\QElectroTech\QElectroTech\macros\ |
| macOS | ~/Library/Application Support/QElectroTech/QElectroTech/macros/ |
La base est l'emplacement « données d'application » de Qt : une installation portable ou en bac à sable (Snap, Flatpak, AppImage avec un dossier personnel dédié) le résoudra à l'intérieur de ce bac à sable.
Vous pouvez déplacer ce dossier — par exemple sur un partage réseau, pour qu'une équipe pioche dans la même bibliothèque — depuis Configuration → Général, au même endroit que les collections d'éléments et de cartouches. Si le chemin configuré n'existe plus, QElectroTech revient au dossier par défaut : vous vous retrouvez avec une liste vide plutôt qu'avec une erreur.
Un modèle est un fichier. Copier un .qetmak dans le dossier le fait
apparaître, le supprimer le retire, et vous pouvez créer des sous-dossiers pour
les organiser.
C'est du XML, et il emporte les définitions des symboles avec lui. C'est ce qui rend un modèle transportable d'un projet à l'autre et d'une machine à l'autre : le projet qui le reçoit n'a pas besoin d'avoir les éléments installés.
<qet_macro>
<collection>
<element path="import/lampe_pe.elmt">
<definition height="50" hotspot_x="15" hotspot_y="25" ...>
...le dessin complet du symbole...
</definition>
</element>
</collection>
<diagram_content>
<diagram projectId="0" ...>
<elements>
...ce que vous aviez sélectionné...
</elements>
</diagram>
</diagram_content>
</qet_macro>| Partie | Ce qu'elle contient |
|---|---|
<collection> |
un <element> par symbole distinct utilisé, avec sa définition complète — un modèle qui utilise six relais identiques ne stocke le relais qu'une fois |
<diagram_content> |
le contenu sélectionné lui-même, sous forme de fragment de folio |
les attributs type
|
réécrits en macro://…, pour que les objets posés se résolvent sur les définitions embarquées |
Un modèle ne contenant qu'une lampe pèse environ 3 ko, presque uniquement la définition du symbole.
Modèle (.qetmak) |
Élément (.elmt) |
Copier-coller | |
|---|---|---|---|
| Contient plusieurs objets et leur câblage | oui | non — un symbole | oui |
| Survit à la fermeture du projet | oui | oui | non, presse-papiers seulement |
| Réutilisable d'un projet à l'autre | oui | oui | seulement si les deux sont ouverts |
| Emporte les définitions de symboles | oui | — | non |
| Se dépose par | glisser depuis l'onglet Modèles | glisser depuis l'onglet Collections | Ctrl+V |
| Se modifie après coup | le recréer depuis une nouvelle sélection | éditeur d'élément | — |
Il n'y a pas d'éditeur de modèles : pour en changer un, déposez-le, corrigez-le sur un folio, et réenregistrez un modèle sous le même nom.
- Le glisser-déposer est le seul moyen de déposer un modèle. Pas d'entrée de menu, pas de raccourci clavier, pas de double-clic — issue #931.
- Les modèles ne se modifient pas sur place. Recréez-les depuis une sélection corrigée.
- Pas de vignette dans le panneau : les modèles sont listés par leur nom seul, donc le nom que vous choisissez est le seul indice de leur contenu — issue #932.
- Si vous utilisez une version de développement antérieure au 13 septembre 2026, glisser un modèle sur un folio ne fait rien sur les versions Qt 6 ; c'est corrigé par la PR #853. Mettez à jour avant de conclure que la fonction est cassée.
« Je sélectionne mon modèle dans la liste et rien ne se pose sur le folio. » C'est normal : sélectionner ne fait rien. Faites-le glisser sur le folio.
« Je l'ai fait glisser et il ne se passe toujours rien. » Vérifiez la date de la version — voir la note Qt 6 ci-dessus. Vérifiez ensuite que vous l'avez lâché dans la zone de dessin du folio et non dans la marge grise.
« L'aperçu reste collé au pointeur. » Une pose est en cours : clic gauche pour la poser, Échap ou clic droit pour annuler.
« Mes modèles ont disparu. »
Le dossier des modèles est configurable dans Configuration → Général. S'il
pointe vers un disque non monté, la collection apparaît vide. Vérifiez le
chemin, ou recopiez les .qetmak dans le dossier par défaut ci-dessus.
- Gérer les collections — le panneau où vit l'onglet Modèles
- Utiliser l'éditeur d'élément — pour dessiner les symboles qu'un modèle assemble
- Configuration — où se règle le dossier des modèles
