Dans les articles pr\u00e9c\u00e9dents, nous avons cr\u00e9\u00e9 un plugin QGIS minimal<\/a>, ajout\u00e9 un bouton dans l\u2019interface et affich\u00e9 une fen\u00eatre (dialog) lorsqu\u2019on clique dessus<\/a>. C\u2019est une \u00e9tape importante\u2026 mais pour l\u2019instant, le plugin ne fait encore rien de concret<\/strong>.<\/p>\n\n\n\n

Dans cet article, nous allons franchir un cap essentiel : r\u00e9cup\u00e9rer les valeurs saisies par l\u2019utilisateur dans la fen\u00eatre et les utiliser dans le code Python du plugin<\/strong>.<\/p>\n\n\n\n

\n\n\n\n<\/span>Mais avant…<\/span><\/h2>\n\n\n\n
Lorsqu\u2019on commence \u00e0 d\u00e9velopper des plugins QGIS, le premier contact avec le code Python peut \u00eatre intimidant. Fichiers multiples, classes, m\u00e9thodes, mots-cl\u00e9s inconnus\u2026 la tentation est grande de refermer l\u2019\u00e9diteur et de se dire : \u00ab ce n\u2019est pas pour moi \u00bb<\/em>.<\/p>\n\n\n\n
Bonne nouvelle : il n\u2019est pas n\u00e9cessaire de tout comprendre pour avancer<\/strong>. Lire du code est une comp\u00e9tence progressive, qui s\u2019apprend \u00e9tape par \u00e9tape.<\/p>\n\n\n\n
Cet article : Comment lire le code d\u2019un plugin QGIS sans paniquer<\/a> a pour objectif de vous donner une m\u00e9thode simple et rassurante<\/strong> pour lire le code d\u2019un plugin QGIS sans paniquer.<\/p>\n\n\n\n
\n\n\n\n
<\/span>1. Pourquoi un bouton ne \u201cfait rien\u201d tout seul<\/span><\/h2>\n\n\n\n
Un point fondamental \u00e0 comprendre :<\/p>\n\n\n\n
\n
Une fen\u00eatre Qt n\u2019ex\u00e9cute aucune action par elle-m\u00eame.<\/p>\n<\/blockquote>\n\n\n\n
Elle sert uniquement \u00e0 :<\/p>\n\n\n\n
\n
afficher des champs (texte, listes, cases \u00e0 cocher\u2026)<\/li>\n\n\n\n
permettre \u00e0 l\u2019utilisateur de saisir ou choisir des valeurs<\/li>\n<\/ul>\n\n\n\n
Si votre plugin ne lit pas explicitement ces valeurs, rien ne se passe<\/strong>, et c\u2019est normal.<\/p>\n\n\n\n
\n\n\n\n
<\/span>2. O\u00f9 sont stock\u00e9es les valeurs de l\u2019interface?<\/span><\/h2>\n\n\n\n
Chaque champ de la fen\u00eatre est un objet Python<\/strong> cr\u00e9\u00e9 \u00e0 partir du fichier .ui<\/code>.<\/p>\n\n\n\n
Par exemple :<\/p>\n\n\n\n
\nQLineEdit<\/code> \u2192 champ de texte<\/li>\n\n\n\n QComboBox<\/code> \u2192 liste d\u00e9roulante<\/li>\n\n\n\n QCheckBox<\/code> \u2192 case \u00e0 cocher<\/li>\n\n\n\n QSpinBox<\/code> \u2192 valeur num\u00e9rique<\/li>\n<\/ul>\n\n\n\nCes objets sont accessibles via l\u2019objet dlg<\/code> (la fen\u00eatre) :<\/p>\n\n\n\n \nself.dlg.lineEdit<\/code><\/li>\n\n\n\n self.dlg.comboBox<\/code><\/li>\n\n\n\n self.dlg.checkBox<\/code><\/li>\n<\/ul>\n\n\n\nLa valeur saisie est stock\u00e9e dans l\u2019objet<\/strong>, pas ailleurs.<\/p>\n\n\n\n \n\n\n\n<\/span>3. Lire une valeur : exemples simples<\/span><\/h2>\n\n\n\n<\/span>Champ texte (QLineEdit)<\/span><\/h3>\n\n\n\n <\/div><\/div><\/div><\/div><\/p>\n\n\n\ntexte = self.dlg.lineEdit.text()\n<\/code><\/pre>\n\n\n\n<\/div><\/div><\/p>\n\n\n\n \u2192 texte<\/code> contient ce que l\u2019utilisateur a tap\u00e9.<\/p>\n\n\n\n \n\n\n\n<\/span>Liste d\u00e9roulante (QComboBox)<\/span><\/h3>\n\n\n\n <\/div><\/div><\/div><\/div><\/p>\n\n\n\nchoix = self.dlg.comboBox.currentText()\n<\/code><\/pre>\n\n\n\n<\/div><\/div><\/p>\n\n\n\n \u2192 choix<\/code> contient l\u2019\u00e9l\u00e9ment s\u00e9lectionn\u00e9.<\/p>\n\n\n\n \n\n\n\n<\/span>Case \u00e0 cocher (QCheckBox)<\/span><\/h3>\n\n\n\n <\/div><\/div><\/div><\/div><\/p>\n\n\n\nactif = self.dlg.checkBox.isChecked()\n<\/code><\/pre>\n\n\n\n<\/div><\/div><\/p>\n\n\n\n \u2192 actif<\/code> vaut True<\/code> ou False<\/code>.<\/p>\n\n\n\n \n\n\n\n<\/span>Champ num\u00e9rique (QSpinBox)<\/span><\/h3>\n\n\n\n <\/div><\/div><\/div><\/div><\/p>\n\n\n\nvaleur = self.dlg.spinBox.value()\n<\/code><\/pre>\n\n\n\n<\/div><\/div><\/p>\n\n\n\n \u2192 valeur<\/code> est un nombre.<\/p>\n\n\n\n \n\n\n\n<\/span>4. Le moment crucial : quand lire les valeurs<\/span><\/h2>\n\n\n\nLes valeurs doivent \u00eatre lues apr\u00e8s<\/strong> que l\u2019utilisateur a valid\u00e9 la fen\u00eatre.<\/p>\n\n\n\n Dans un plugin QGIS classique, cela se fait apr\u00e8s :<\/p>\n\n\n\n <\/div><\/div><\/div><\/div><\/p>\n\n\n\nresult = self.dlg.exec_()\n\nif result:\n # lire les valeurs ici\n<\/code><\/pre>\n\n\n\n<\/div><\/div><\/p>\n\n\n\n \nLire les valeurs avant exec_()<\/code> revient \u00e0 lire des champs encore vides.<\/p>\n<\/blockquote>\n\n\n\n \n\n\n\n<\/span>5. Exemple complet minimal<\/span><\/h2>\n\n\n\nVoici un exemple simple et volontairement minimaliste :<\/p>\n\n\n\n <\/div><\/div><\/div><\/div><\/p>\n\n\n\nresult = self.dlg.exec_()\n\nif result:\n texte = self.dlg.lineEdit.text()\n choix = self.dlg.comboBox.currentText()\n actif = self.dlg.checkBox.isChecked()\n\n print(\"Texte :\", texte)\n print(\"Choix :\", choix)\n print(\"Option active :\", actif)\n<\/code><\/pre>\n\n\n\n<\/div><\/div><\/p>\n\n\n\n \u00c0 ce stade :<\/p>\n\n\n\n \naucune analyse<\/li>\n\n\n\n aucun traitement complexe<\/li>\n\n\n\n juste la preuve que le plugin r\u00e9cup\u00e8re bien les informations<\/strong><\/li>\n<\/ul>\n\n\n\n \n\n\n\n<\/span>Pourquoi rien ne se passe si vous ne lisez pas les valeurs ?<\/span><\/h3>\n\n\n\n\n\nC\u2019est une question fr\u00e9quente chez les d\u00e9butants.<\/p>\n<\/blockquote>\n\n\n\n \nUn plugin QGIS n\u2019est pas un formulaire automatique. Il n\u2019y a pas de magie cach\u00e9e.<\/p>\n<\/blockquote>\n\n\n\n \nSi vous ne lisez pas explicitement une valeur, elle n\u2019est jamais utilis\u00e9e.<\/p>\n<\/blockquote>\n\n\n\n \nCette logique est volontaire : elle vous laisse le contr\u00f4le total<\/strong> sur le comportement du plugin.<\/p>\n<\/blockquote>\n<\/div><\/div>\n\n\n\n \n\n\n\n<\/span>6. Ce que vous savez faire maintenant<\/span><\/h2>\n\n\n\n\u00c0 la fin de cet article, vous savez :<\/p>\n\n\n\n \no\u00f9 sont stock\u00e9es les valeurs saisies par l\u2019utilisateur<\/li>\n\n\n\n comment les lire en Python<\/li>\n\n\n\n quand les lire<\/li>\n\n\n\n pourquoi rien ne se passe sans cette \u00e9tape<\/li>\n<\/ul>\n\n\n\nDans le prochain article, nous verrons comment transformer ces valeurs en actions concr\u00e8tes<\/strong> : traitement, calcul, interaction avec les couches QGIS.<\/p>\n\n\n\n \n\n\n\n➡️ Article suivant : D\u00e9velopper un plugin QGIS \u2013 appliquer une logique m\u00e9tier aux valeurs saisies<\/em><\/p>\n\n\n\n \n","protected":false},"excerpt":{"rendered":"Quand on d\u00e9bute dans le d\u00e9veloppement de plugins QGIS, on a souvent l\u2019impression qu\u2019un bouton devrait \u201cfaire quelque chose\u201d tout seul. En r\u00e9alit\u00e9, un bouton ne fait rien\u2026 tant qu\u2019on ne lui explique pas quoi faire.…<\/p>\n","protected":false},"author":1,"featured_media":16325,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"sfsi_plus_gutenberg_text_before_share":"","sfsi_plus_gutenberg_show_text_before_share":"","sfsi_plus_gutenberg_icon_type":"","sfsi_plus_gutenberg_icon_alignemt":"","sfsi_plus_gutenburg_max_per_row":"","_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[1945,62],"tags":[4678,4732,4734,4736,4730,4738,4740,4742],"class_list":["post-16312","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-pluigin","category-qgis-2","tag-pyqgis","tag-qcheckbox-fr","tag-qcombobox-fr","tag-qgis-dialog-fr","tag-qgis-plugin-development-fr","tag-qlineedit-fr","tag-qspinbox-fr","tag-qt-designer-fr"],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t