Modèles (l'onglet « Modèles »)

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.

1. Créer un modèle

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.

2. Déposer un modèle

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

3. Où sont rangés les modèles

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.

4. Ce que contient un fichier `.qetmak`

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.

5. Modèles, éléments et copier-coller

	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.

6. Limites

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.

7. En cas de problème

« 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.

Voir aussi

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

Getting Started

Home

🌐 Languages — English · Français · Deutsch

Downloads

Quick Start Guide

User Manual

FAQ

Tips & Tricks

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