Dans QGIS, l\u2019utilisateur s\u00e9lectionne rarement des entit\u00e9s par hasard<\/strong>.
Une s\u00e9lection exprime presque toujours une intention pr\u00e9cise : \u00ab je veux agir sur ces objets-l\u00e0, et pas les autres \u00bb<\/em>.<\/p>\n\n\n\n

Un plugin qui ignore cette s\u00e9lection et traite toute la couche :<\/p>\n\n\n\n

\n
peut produire des erreurs graves,<\/li>\n\n\n\n
casse la confiance,<\/li>\n\n\n\n
devient dangereux \u00e0 utiliser.<\/li>\n<\/ul>\n\n\n\n
\n
Par d\u00e9faut, un plugin bien con\u00e7u doit respecter la s\u00e9lection active.<\/strong><\/p>\n<\/blockquote>\n\n\n\n
\n\n\n\n
<\/span>Comment QGIS g\u00e8re une s\u00e9lection d\u2019entit\u00e9s<\/span><\/h2>\n\n\n\n
Dans QGIS :<\/p>\n\n\n\n
\n
la s\u00e9lection appartient \u00e0 la couche<\/strong><\/li>\n\n\n\n
elle est volatile<\/strong> (elle change \u00e0 chaque action utilisateur)<\/li>\n\n\n\n
elle est accessible directement depuis l\u2019API PyQGIS<\/li>\n<\/ul>\n\n\n\n
Une couche vectorielle sait \u00e0 tout moment :<\/p>\n\n\n\n
\n
combien d\u2019entit\u00e9s sont s\u00e9lectionn\u00e9es<\/li>\n\n\n\n
lesquelles elles sont<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n
<\/span>R\u00e9cup\u00e9rer la couche active<\/span><\/h2>\n\n\n\n
Dans un plugin, on commence presque toujours par r\u00e9cup\u00e9rer la couche active :<\/p>\n\n\n
<\/div>
<\/div>
<\/div><\/div>
<\/p>\n\n\n\n
layer = iface.activeLayer()\n<\/code><\/pre>\n\n\n<\/div><\/div>\n\n\n\n Premi\u00e8re r\u00e8gle de s\u00e9curit\u00e9 :<\/p>\n\n\n <\/div><\/div><\/div><\/div><\/p>\n\n\n\nif not layer:\n return\n<\/code><\/pre>\n\n\n<\/div><\/div>\n\n\n\n \nPas de couche active = pas d\u2019action.<\/p>\n<\/blockquote>\n\n\n\n \n\n\n\n<\/span>V\u00e9rifier qu\u2019il y a une s\u00e9lection<\/span><\/h2>\n\n\n\nAvant tout traitement, il faut v\u00e9rifier que l\u2019utilisateur a bien s\u00e9lectionn\u00e9 quelque chose :<\/p>\n\n\n <\/div><\/div><\/div><\/div><\/p>\n\n\n\nselected_features = layer.selectedFeatures()\n\nif not selected_features:\n # aucune entit\u00e9 s\u00e9lectionn\u00e9e\n return\n<\/code><\/pre>\n\n\n<\/div><\/div>\n\n\n\n \u00c0 ce stade, le plugin sait d\u00e9j\u00e0 :<\/p>\n\n\n\n \ns\u2019il doit continuer<\/li>\n\n\n\n ou s\u2019il doit s\u2019arr\u00eater proprement<\/li>\n<\/ul>\n\n\n\n \n\n\n\n<\/span>Travailler sur les entit\u00e9s s\u00e9lectionn\u00e9es<\/span><\/h2>\n\n\n\nselectedFeatures()<\/code> retourne une liste d\u2019objets QgsFeature<\/strong>.<\/p>\n\n\n\n Vous pouvez donc les parcourir simplement :<\/p>\n\n\n <\/div><\/div><\/div><\/div><\/p>\n\n\n\nfor feature in selected_features:\n # traitement sur chaque entit\u00e9\n<\/code><\/pre>\n\n\n<\/div><\/div>\n\n\n\n Chaque feature<\/code> contient :<\/p>\n\n\n\n \nses attributs<\/li>\n\n\n\n sa g\u00e9om\u00e9trie<\/li>\n\n\n\n son identifiant unique<\/li>\n<\/ul>\n\n\n\n \n\n\n\n<\/span>Exemple simple : lire un attribut<\/span><\/h2>\n\n\n<\/div><\/div><\/div><\/div><\/p>\n\n\n\nfor feature in selected_features:\n valeur = feature[\"population\"]\n<\/code><\/pre>\n\n\n<\/div><\/div>\n\n\n\n \nSi le champ n\u2019existe pas, une erreur se produira : d\u2019o\u00f9 l\u2019importance de v\u00e9rifier la structure de la couche (voir article pr\u00e9c\u00e9dent).<\/p>\n<\/blockquote>\n\n\n\n \n\n\n\n<\/span>Modifier des attributs (avec pr\u00e9caution)<\/span><\/h2>\n\n\n\nModifier une entit\u00e9 s\u00e9lectionn\u00e9e n\u00e9cessite que la couche soit en mode \u00e9dition<\/strong>.<\/p>\n\n\n <\/div><\/div><\/div><\/div><\/p>\n\n\n\nif not layer.isEditable():\n layer.startEditing()\n<\/code><\/pre>\n\n\n<\/div><\/div>\n\n\n\n Puis :<\/p>\n\n\n <\/div><\/div><\/div><\/div><\/p>\n\n\n\nfor feature in selected_features:\n feature[\"statut\"] = \"trait\u00e9\"\n layer.updateFeature(feature)\n<\/code><\/pre>\n\n\n<\/div><\/div>\n\n\n\n Enfin :<\/p>\n\n\n <\/div><\/div><\/div><\/div><\/p>\n\n\n\nlayer.commitChanges()\n<\/code><\/pre>\n\n\n<\/div><\/div>\n\n\n\n \n Un plugin ne doit jamais forcer silencieusement des modifications.<\/strong> Dans la suite de la s\u00e9rie, on verra comment demander confirmation \u00e0 l\u2019utilisateur.<\/p>\n<\/blockquote>\n\n\n\n \n\n\n\n\n<\/span>S\u00e9lection active \u2260 filtre \u2260 couche temporaire<\/strong><\/span><\/h3>\n\n\n\nDans QGIS, plusieurs m\u00e9canismes permettent de travailler sur un sous-ensemble de donn\u00e9es. Ils se ressemblent visuellement, mais n\u2019ont pas du tout le m\u00eame comportement<\/strong>, surtout dans un plugin.<\/p>\n\n\n\n \n\n\n\n<\/span>🔹 S\u00e9lection active<\/span><\/h4>\n\n\n\n\nAppartient \u00e0 la couche<\/strong><\/li>\n\n\n\n Visible par surlignage<\/li>\n\n\n\n Accessible via selectedFeatures()<\/code><\/li>\n\n\n\n Volatile<\/strong> : change \u00e0 chaque action utilisateur<\/li>\n<\/ul>\n\n\n\n C\u2019est le m\u00e9canisme le plus s\u00fbr et le plus explicite<\/strong> pour un plugin.<\/p>\n\n\n\n \n\n\n\n<\/span>🔹 Filtre (requ\u00eate de couche)<\/span><\/h4>\n\n\n\n\nCache les entit\u00e9s non conformes<\/li>\n\n\n\n La couche semble<\/em> ne contenir que certaines entit\u00e9s<\/li>\n\n\n\n Le plugin voit toujours la couche enti\u00e8re<\/strong>, sauf pr\u00e9caution sp\u00e9cifique<\/li>\n<\/ul>\n\n\n\n Un plugin mal \u00e9crit peut modifier des entit\u00e9s invisibles<\/strong>.<\/p>\n\n\n\n \n\n\n\n<\/span>🔹 Couche temporaire<\/span><\/h4>\n\n\n\n\nR\u00e9sultat d\u2019un traitement ou d\u2019une extraction<\/li>\n\n\n\n Ind\u00e9pendante de la couche d\u2019origine<\/li>\n\n\n\n Peut dispara\u00eetre \u00e0 la fermeture du projet<\/li>\n<\/ul>\n\n\n\n Utile pour tester ou visualiser, pas toujours pour modifier les donn\u00e9es sources<\/strong>.<\/p>\n\n\n\n \n\n\n\n<\/span>\u00c0 retenir<\/span><\/h3>\n\n\n\n\nS\u00e9lection = intention explicite de l\u2019utilisateur<\/strong><\/li>\n\n\n\n Filtre = vue partielle<\/strong><\/li>\n\n\n\n Couche temporaire = copie de travail<\/strong><\/li>\n<\/ul>\n\n\n\n Dans un plugin m\u00e9tier, la s\u00e9lection active est presque toujours le meilleur point d\u2019entr\u00e9e<\/strong><\/p>\n<\/blockquote>\n\n\n\n \n\n\n\n<\/span>Et si aucune entit\u00e9 n\u2019est s\u00e9lectionn\u00e9e ?<\/span><\/h2>\n\n\n\nDeux options int\u00e9ressantes :<\/p>\n\n\n\n <\/span>Option 1 \u2013 Bloquer l\u2019action<\/span><\/h3>\n\n\n\n\n\u00ab Veuillez s\u00e9lectionner au moins une entit\u00e9 \u00bb<\/p>\n<\/blockquote>\n\n\n\n C\u2019est la plus s\u00fbre.<\/p>\n\n\n\n <\/span>Option 2 \u2013 Proposer une alternative<\/span><\/h3>\n\n\n\n\n\u00ab Aucune entit\u00e9 s\u00e9lectionn\u00e9e. Voulez-vous appliquer l\u2019action \u00e0 toute la couche ? \u00bb<\/p>\n<\/blockquote>\n\n\n\n \n Toujours laisser le choix \u00e0 l\u2019utilisateur.<\/strong><\/p>\n<\/blockquote>\n\n\n\n \n\n\n\n<\/span>Cas d\u2019usage typiques dans un plugin<\/span><\/h2>\n\n\n\nTravailler uniquement sur la s\u00e9lection est indispensable pour :<\/p>\n\n\n\n \nrecalculer un attribut sur un sous-ensemble<\/li>\n\n\n\n corriger des g\u00e9om\u00e9tries cibl\u00e9es<\/li>\n\n\n\n appliquer une logique m\u00e9tier locale<\/li>\n\n\n\n pr\u00e9parer des donn\u00e9es avant export<\/li>\n\n\n\n valider des objets pr\u00e9cis<\/li>\n<\/ul>\n\n\n\nEn pratique, 90 % des plugins m\u00e9tiers devraient fonctionner ainsi<\/strong>.<\/p>\n\n\n\n \n\n\n\n<\/span>\u00c0 retenir<\/span><\/h2>\n\n\n\n\nUne s\u00e9lection = une intention utilisateur<\/li>\n\n\n\n Un plugin doit la respecter par d\u00e9faut<\/li>\n\n\n\n Le code n\u00e9cessaire est simple et lisible<\/li>\n\n\n\n La s\u00e9curit\u00e9 vient plus de la logique que de la complexit\u00e9<\/li>\n<\/ul>\n\n\n\n \n\n\n\n<\/p>\n","protected":false},"excerpt":{"rendered":" Dans QGIS, de nombreuses actions ne doivent s\u2019appliquer qu\u2019\u00e0 une partie des donn\u00e9es : une s\u00e9lection d\u2019entit\u00e9s pr\u00e9cise, choisie par l\u2019utilisateur.Dans cet article, nous allons voir comment un plugin QGIS peut d\u00e9tecter, contr\u00f4ler et traiter uniquement…<\/p>\n","protected":false},"author":1,"featured_media":16333,"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":[4788,4222,4786,4782,4784,4678,4790],"class_list":["post-16332","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-pluigin","category-qgis-2","tag-commitchanges-fr","tag-developpement-plugin-qgis","tag-integrite-des-donnees","tag-mode-edition-qgis","tag-modification-dattributs-qgis","tag-pyqgis","tag-rollback-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