{"id":16384,"date":"2026-06-11T10:00:00","date_gmt":"2026-06-11T08:00:00","guid":{"rendered":"https:\/\/www.sigterritoires.fr\/?p=16384"},"modified":"2026-06-11T10:03:56","modified_gmt":"2026-06-11T08:03:56","slug":"desarrollar-plugin-qgis-anadir-boton-ventana","status":"publish","type":"post","link":"https:\/\/www.sigterritoires.fr\/index.php\/es\/desarrollar-plugin-qgis-anadir-boton-ventana\/","title":{"rendered":"[ES]Desarrollar un plugin QGIS: a\u00f1adir un bot\u00f3n y una ventana"},"content":{"rendered":"\n

\n\n\n\n

A\u00f1adir un bot\u00f3n en la interfaz de QGIS suele ser el primer paso concreto cuando se desarrolla un plugin. Es lo que transforma un simple script en Python en una herramienta realmente utilizable por el usuario.<\/p>\n\n\n\n

En este tercer art\u00edculo del tutorial, veremos c\u00f3mo a\u00f1adir un bot\u00f3n y mostrar una ventana en un plugin QGIS<\/strong>, apoy\u00e1ndonos en el c\u00f3digo generado por Plugin Builder. Nos detendremos en los elementos esenciales: el m\u00e9todo initGui()<\/code>, las acciones (QAction<\/code>) y el disparo del di\u00e1logo.<\/p>\n\n\n\n

Este tutorial est\u00e1 dirigido a principiantes en el desarrollo de plugins QGIS<\/strong>, que desean comprender c\u00f3mo interactuar con la interfaz de QGIS antes de avanzar hacia la l\u00f3gica de negocio.<\/p>\n\n\n\n

\n\n\n\n\n\n\n \n\n\n\n\n\nContenu <\/p>\nToggle<\/span> A\u00f1adir un bot\u00f3n y mostrar una ventana en QGIS<\/a><\/li> Recordatorio: el plugin generado por Plugin Builder<\/a><\/li> El archivo principal del plugin<\/a><\/li> El m\u00e9todo initGui(): punto de entrada visual<\/a><\/li> El m\u00e9todo run(): qu\u00e9 ocurre al hacer clic<\/a><\/li> 📦 Qu\u00e9 hace realmente un bot\u00f3n en QGIS<\/a><\/li> Comprender la ventana (di\u00e1logo)<\/a><\/li> Modificar el texto de la ventana<\/a><\/li> Probar y recargar el plugin<\/a><\/li> Errores frecuentes en esta etapa<\/a><\/li> Lo que has aprendido<\/a><\/li> \u00bfY en el pr\u00f3ximo art\u00edculo?<\/a><\/li><\/ul><\/nav><\/div>\n<\/span>A\u00f1adir un bot\u00f3n y mostrar una ventana en QGIS<\/span><\/h2>\n\n\n\nEn los dos primeros art\u00edculos sentamos las bases: entender qu\u00e9 es un plugin QGIS y crear un plugin vac\u00edo con Plugin Builder. Ahora es el momento de darle un comportamiento visible a nuestro plugin.<\/p>\n\n\n\n En este art\u00edculo aprenderemos a:<\/p>\n\n\n\n \na\u00f1adir un bot\u00f3n en la interfaz de QGIS,<\/li>\n\n\n\n comprender el c\u00f3digo generado por Plugin Builder,<\/li>\n\n\n\n mostrar una ventana (di\u00e1logo) sencilla.<\/li>\n<\/ul>\n\n\n\nEl objetivo no es a\u00fan hacer algo complejo, sino comprender el mecanismo fundamental de cualquier plugin QGIS<\/strong>.<\/p>\n\n\n\n \n\n\n\n<\/span>Recordatorio: el plugin generado por Plugin Builder<\/span><\/h2>\n\n\n\nCuando elegimos la plantilla \u201cTool button with dialog\u201d<\/strong>, Plugin Builder ya prepar\u00f3 muchos elementos por nosotros:<\/p>\n\n\n\n \nun bot\u00f3n en la barra de herramientas,<\/li>\n\n\n\n una entrada de men\u00fa en QGIS,<\/li>\n\n\n\n una ventana gr\u00e1fica asociada.<\/li>\n<\/ul>\n\n\n\nAunque todo funcione desde el principio, es fundamental entender c\u00f3mo est\u00e1 conectado todo<\/strong>.<\/p>\n\n\n\n \n\n\n\n<\/span>El archivo principal del plugin<\/span><\/h2>\n\n\n\nAbre el archivo Python principal de tu plugin (por ejemplo mi_primer_plugin.py<\/code>).<\/p>\n\n\n\n Encontrar\u00e1s una clase principal que lleva el nombre del plugin. Es ella la que controla todo el comportamiento.<\/p>\n\n\n\n class MiPrimerPlugin:\n def __init__(self, iface):\n self.iface = iface\n<\/code><\/pre>\n\n\n\n👉 iface<\/code> es el objeto que permite al plugin comunicarse con QGIS (men\u00fas, capas, mensajes, etc.).<\/p>\n\n\n\n \n\n\n\n<\/span>El m\u00e9todo initGui()<\/code>: punto de entrada visual<\/span><\/h2>\n\n\n\nEl m\u00e9todo initGui()<\/code> se llama autom\u00e1ticamente cuando el plugin se activa en QGIS.<\/p>\n\n\n\n Aqu\u00ed se definen:<\/p>\n\n\n\n \nel bot\u00f3n en la barra de herramientas,<\/li>\n\n\n\n la entrada de men\u00fa,<\/li>\n\n\n\n la acci\u00f3n asociada.<\/li>\n<\/ul>\n\n\n\nEjemplo t\u00edpico:<\/p>\n\n\n\n def initGui(self):\n self.action = QAction(\n QIcon(':\/plugins\/MiPrimerPlugin\/icon.png'),\n 'Mi primer plugin',\n self.iface.mainWindow()\n )\n self.action.triggered.connect(self.run)\n self.iface.addToolBarIcon(self.action)\n<\/code><\/pre>\n\n\n\nAunque no entiendas cada l\u00ednea en detalle, recuerda que:<\/p>\n\n\n\n \nse crea una acci\u00f3n,<\/li>\n\n\n\n se conecta a un m\u00e9todo (run<\/code>),<\/li>\n\n\n\n se a\u00f1ade a la interfaz de QGIS.<\/li>\n<\/ul>\n\n\n\n \n\n\n\n<\/span>El m\u00e9todo run()<\/code>: qu\u00e9 ocurre al hacer clic<\/span><\/h2>\n\n\n\nEl m\u00e9todo run()<\/code> se ejecuta cuando el usuario hace clic en el bot\u00f3n del plugin.<\/p>\n\n\n\n En la plantilla generada, su funci\u00f3n principal es mostrar una ventana.<\/p>\n\n\n\n def run(self):\n self.dlg.show()\n<\/code><\/pre>\n\n\n\n👉 En este punto, el plugin solo hace una cosa: abrir un di\u00e1logo<\/strong>.<\/p>\n\n\n\n \n\n\n\n<\/span>📦 Qu\u00e9 hace realmente un bot\u00f3n en QGIS<\/span><\/h2>\n\n\n\nCuando se hace clic en un bot\u00f3n en QGIS, no ocurre nada \u201cm\u00e1gico\u201d.<\/p>\n\n\n\n Un bot\u00f3n de plugin es simplemente un disparador<\/strong> que llama a una funci\u00f3n Python concreta.<\/p>\n\n\n\n El funcionamiento es siempre el mismo:<\/p>\n\n\n\n \nel plugin crea una acci\u00f3n (QAction<\/code>),<\/li>\n\n\n\n esa acci\u00f3n se asocia a una funci\u00f3n (por ejemplo run()<\/code>),<\/li>\n\n\n\n cuando el usuario hace clic, QGIS ejecuta esa funci\u00f3n.<\/li>\n<\/ul>\n\n\n\nEn nuestro caso, la funci\u00f3n run()<\/code> solo muestra una ventana. Pero m\u00e1s adelante, esa misma funci\u00f3n podr\u00e1:<\/p>\n\n\n\n \nleer par\u00e1metros introducidos por el usuario,<\/li>\n\n\n\n analizar capas,<\/li>\n\n\n\n lanzar procesos,<\/li>\n\n\n\n producir resultados.<\/li>\n<\/ul>\n\n\n\n👉 Un bot\u00f3n en QGIS solo hace una cosa: ejecutar c\u00f3digo Python<\/strong>. Toda la potencia del plugin est\u00e1 en ese c\u00f3digo.<\/p>\n\n\n\n \n\n\n\n<\/span>Comprender la ventana (di\u00e1logo)<\/span><\/h2>\n\n\n\nLa ventana mostrada est\u00e1 definida en un archivo .ui<\/code>, creado con Qt Designer<\/strong>.<\/p>\n\n\n\n Este archivo se carga luego en Python, lo que permite:<\/p>\n\n\n\n \nmostrar la ventana,<\/li>\n\n\n\n recuperar los valores introducidos por el usuario,<\/li>\n\n\n\n conectar botones a c\u00f3digo.<\/li>\n<\/ul>\n\n\n\nPor ahora, vamos a limitarnos a modificar el aspecto visual.<\/p>\n\n\n\n \n\n\n\n<\/span>Modificar el texto de la ventana<\/span><\/h2>\n\n\n\nAbre el archivo .ui<\/code> con Qt Designer.<\/p>\n\n\n\n Prueba, por ejemplo, a:<\/p>\n\n\n\n \ncambiar el t\u00edtulo de la ventana,<\/li>\n\n\n\n modificar un texto (label),<\/li>\n\n\n\n a\u00f1adir un bot\u00f3n.<\/li>\n<\/ul>\n\n\n\nGuarda el archivo, recarga el plugin en QGIS y haz clic en el bot\u00f3n.<\/p>\n\n\n\n 👉 Acabas de modificar la interfaz de un plugin QGIS sin escribir c\u00f3digo Python<\/strong>.<\/p>\n\n\n\n \n\n\n\n<\/span>Probar y recargar el plugin<\/span><\/h2>\n\n\n\nCada vez que modifiques el c\u00f3digo o la interfaz:<\/p>\n\n\n\n \ndesactiva el plugin en el gestor de extensiones,<\/li>\n\n\n\n vuelve a activarlo,<\/li>\n<\/ul>\n\n\n\no utiliza la opci\u00f3n Recargar plugin<\/strong> si tienes instalada la extensi\u00f3n correspondiente.<\/p>\n\n\n\n \n\n\n\n<\/span>Errores frecuentes en esta etapa<\/span><\/h2>\n\n\n\n\nno pasa nada al hacer clic \u2192 el m\u00e9todo run()<\/code> no est\u00e1 conectado<\/li>\n\n\n\n error al cargar \u2192 error de may\u00fasculas\/min\u00fasculas en los nombres<\/li>\n\n\n\n ventana vac\u00eda \u2192 archivo .ui<\/code> mal referenciado<\/li>\n<\/ul>\n\n\n\nEstos problemas son normales y forman parte del aprendizaje.<\/p>\n\n\n\n \n\n\n\n<\/span>Lo que has aprendido<\/span><\/h2>\n\n\n\nAl finalizar este art\u00edculo, sabes:<\/p>\n\n\n\n \nd\u00f3nde se crea el bot\u00f3n de un plugin QGIS,<\/li>\n\n\n\n c\u00f3mo una acci\u00f3n se conecta a c\u00f3digo,<\/li>\n\n\n\n c\u00f3mo mostrar y modificar una ventana.<\/li>\n<\/ul>\n\n\n\nYa tienes el bloque esencial de cualquier plugin QGIS interactivo<\/strong>.<\/p>\n\n\n\n \n\n\n\n<\/span>\u00bfY en el pr\u00f3ximo art\u00edculo?<\/span><\/h2>\n\n\n\nEn el siguiente art\u00edculo veremos:<\/p>\n\n\n\n \nc\u00f3mo recuperar los valores introducidos en la ventana,<\/li>\n\n\n\n c\u00f3mo interactuar con las capas de QGIS,<\/li>\n\n\n\n c\u00f3mo estructurar el c\u00f3digo para ir m\u00e1s lejos.<\/li>\n<\/ul>\n\n\n\n👉 A partir de aqu\u00ed, tu plugin empieza de verdad a ser \u00fatil.<\/p>\n\n\n\n \n\n\n\n<\/p>\n","protected":false},"excerpt":{"rendered":" A\u00f1adir un bot\u00f3n en la interfaz de QGIS suele ser el primer paso concreto cuando se desarrolla un plugin. Es lo que transforma un simple script en Python en una herramienta realmente utilizable por el usuario.…<\/p>\n","protected":false},"author":1,"featured_media":16327,"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":[3442,1357],"tags":[4208,4210,4212,4206,1369],"class_list":["post-16384","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-pluigin-es","category-qgis-es","tag-boton","tag-dialogo","tag-plugin-builder-fr-es","tag-pluigin","tag-qgis-es"],"aioseo_notices":[],"jetpack_featured_media_url":"https:\/\/i0.wp.com\/www.sigterritoires.fr\/wp-content\/uploads\/2026\/01\/pluginsQGIS3.jpg?fit=409%2C307&ssl=1","jetpack_shortlink":"https:\/\/wp.me\/p6XU0A-4gg","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/posts\/16384","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/comments?post=16384"}],"version-history":[{"count":0,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/posts\/16384\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/media\/16327"}],"wp:attachment":[{"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/media?parent=16384"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/categories?post=16384"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/tags?post=16384"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}