En los art\u00edculos anteriores, creamos un plugin QGIS m\u00ednimo, a\u00f1adimos un bot\u00f3n a la interfaz y mostramos una ventana de di\u00e1logo al hacer clic sobre \u00e9l.<\/p>\n\n\n\n

Ese fue un paso importante.<\/p>\n\n\n\n

Sin embargo, nuestro plugin todav\u00eda no realiza ninguna tarea \u00fatil.<\/p>\n\n\n\n

En este art\u00edculo vamos a dar el siguiente paso fundamental: recuperar los valores introducidos por el usuario y utilizarlos en el c\u00f3digo Python del plugin.<\/p>\n\n\n\n

Pero antes…<\/p>\n\n\n\n

Cuando una persona comienza a desarrollar plugins QGIS, su primer contacto con el c\u00f3digo Python puede resultar intimidante.<\/p>\n\n\n\n

M\u00faltiples archivos, clases, m\u00e9todos y palabras clave desconocidas pueden dar la impresi\u00f3n de que todo es mucho m\u00e1s complicado de lo que realmente es.<\/p>\n\n\n\n

La buena noticia es que no es necesario comprenderlo todo desde el principio.<\/p>\n\n\n\n

Leer c\u00f3digo es una habilidad que se adquiere progresivamente.<\/p>\n\n\n\n

Si todav\u00eda no lo has le\u00eddo, te recomendamos consultar:<\/p>\n\n\n\n

C\u00f3mo Leer el C\u00f3digo de un Plugin QGIS sin Entrar en P\u00e1nico<\/a><\/strong><\/p>\n\n\n\n

Ese art\u00edculo propone un m\u00e9todo sencillo y tranquilizador para comprender el c\u00f3digo de un plugin sin sentirse abrumado.<\/p>\n\n\n\n

\n\n\n\n
<\/span>\u00bfPor qu\u00e9 un bot\u00f3n no \u201chace nada\u201d por s\u00ed solo?<\/span><\/h2>\n\n\n\n
Hay un concepto fundamental que conviene entender desde el principio:<\/p>\n\n\n\n
\n
Una ventana de di\u00e1logo Qt no ejecuta ninguna acci\u00f3n por s\u00ed misma.<\/p>\n<\/blockquote>\n\n\n\n
Su funci\u00f3n consiste \u00fanicamente en:<\/p>\n\n\n\n
\n
mostrar campos de entrada,<\/li>\n\n\n\n
permitir al usuario introducir o seleccionar valores,<\/li>\n\n\n\n
presentar informaci\u00f3n mediante una interfaz gr\u00e1fica.<\/li>\n<\/ul>\n\n\n\n
Por ejemplo, una ventana puede contener:<\/p>\n\n\n\n
\n
campos de texto,<\/li>\n\n\n\n
listas desplegables,<\/li>\n\n\n\n
casillas de verificaci\u00f3n,<\/li>\n\n\n\n
campos num\u00e9ricos.<\/li>\n<\/ul>\n\n\n\n
Si el plugin nunca lee esos valores, no ocurrir\u00e1 nada.<\/p>\n\n\n\n
Y eso es completamente normal.<\/p>\n\n\n\n
La ventana es \u00fanicamente la interfaz de usuario.<\/p>\n\n\n\n
El comportamiento real del plugin est\u00e1 definido por el c\u00f3digo Python que recupera y utiliza esos valores.<\/p>\n\n\n\n
\n\n\n\n
<\/span>\u00bfD\u00f3nde se almacenan los valores?<\/span><\/h2>\n\n\n\n
Cada campo mostrado en una ventana es un objeto Python creado a partir del archivo .ui<\/code> dise\u00f1ado con Qt Designer.<\/p>\n\n\n\n
Algunos ejemplos habituales son:<\/p>\n\n\n\n
\nQLineEdit<\/code> \u2192 campo de texto<\/li>\n\n\n\n QComboBox<\/code> \u2192 lista desplegable<\/li>\n\n\n\n QCheckBox<\/code> \u2192 casilla de verificaci\u00f3n<\/li>\n\n\n\n QSpinBox<\/code> \u2192 campo num\u00e9rico<\/li>\n<\/ul>\n\n\n\nEstos widgets son accesibles a trav\u00e9s del objeto de di\u00e1logo, normalmente llamado dlg<\/code>.<\/p>\n\n\n\n Por ejemplo:<\/p>\n\n\n <\/div><\/div><\/div><\/div><\/p>\nself.dlg.lineEdit<\/p>\n self.dlg.comboBox<\/p>\n self.dlg.checkBox<\/p>\n <\/div><\/div>\n\n\n\n El valor introducido por el usuario se almacena dentro del propio widget.<\/p>\n\n\n\n No existe ning\u00fan almacenamiento oculto.<\/p>\n\n\n\n Si el plugin necesita ese valor, debe recuperarlo expl\u00edcitamente desde el widget correspondiente.<\/p>\n\n\n\n Esta idea tan simple constituye la base de toda interacci\u00f3n entre el usuario y un plugin QGIS.<\/p>\n\n\n\n \n\n\n\n<\/span>Leer valores: ejemplos sencillos<\/span><\/h2>\n\n\n\nUna vez que sabes d\u00f3nde se almacenan los valores, el siguiente paso consiste en recuperarlos desde los widgets de la ventana.<\/p>\n\n\n\n Cada tipo de widget dispone de su propio m\u00e9todo para acceder a los datos introducidos por el usuario.<\/p>\n\n\n\n \n\n\n\n<\/span>Campo de texto (QLineEdit<\/code>)<\/span><\/h3>\n\n\n<\/div><\/div><\/div><\/div><\/p>\ntexto = self.dlg.lineEdit.text()<\/p>\n <\/div><\/div>\n\n\n\n \n texto<\/code> contiene lo que el usuario ha escrito en el campo.<\/p>\n<\/blockquote>\n\n\n\n \n\n\n\n<\/span>Lista desplegable (QComboBox<\/code>)<\/span><\/h3>\n\n\n<\/div><\/div><\/div><\/div><\/p>\nopcion = self.dlg.comboBox.currentText()<\/p>\n <\/div><\/div>\n\n\n\n \n opcion<\/code> contiene el elemento actualmente seleccionado.<\/p>\n<\/blockquote>\n\n\n\n \n\n\n\n<\/span>Casilla de verificaci\u00f3n (QCheckBox<\/code>)<\/span><\/h3>\n\n\n<\/div><\/div><\/div><\/div><\/p>\nactivo = self.dlg.checkBox.isChecked()<\/p>\n <\/div><\/div>\n\n\n\n \n activo<\/code> contiene True<\/code> o False<\/code>.<\/p>\n<\/blockquote>\n\n\n\n <\/span>Campo num\u00e9rico (QSpinBox<\/code>)<\/span><\/h3>\n\n\n<\/div><\/div><\/div><\/div><\/p>\nvalor = self.dlg.spinBox.value()<\/p>\n <\/div><\/div>\n\n\n\n \n valor<\/code> contiene un valor num\u00e9rico.<\/p>\n<\/blockquote>\n\n\n\n En esta etapa no es necesario comprender todos los detalles t\u00e9cnicos.<\/p>\n\n\n\n Lo importante es recordar que cada widget dispone de un m\u00e9todo espec\u00edfico para acceder a su contenido.<\/p>\n\n\n\n \n\n\n\n<\/span>El momento crucial: \u00bfcu\u00e1ndo leer los valores?<\/span><\/h2>\n\n\n\nUno de los errores m\u00e1s frecuentes entre los principiantes consiste en intentar leer los valores antes de que el usuario haya validado la ventana.<\/p>\n\n\n\n En un plugin QGIS cl\u00e1sico, los valores solo deben recuperarse despu\u00e9s de que el usuario haya aceptado el di\u00e1logo.<\/p>\n\n\n\n Por ejemplo:<\/p>\n\n\n <\/div><\/div><\/div><\/div><\/p>\nresult = self.dlg.exec_()<\/p>\n if result: \n# leer los valores aqu\u00ed<\/p>\n <\/div><\/div>\n\n\n\n La llamada a exec_()<\/code> muestra la ventana y espera a que el usuario interact\u00fae con ella.<\/p>\n\n\n\n Solo cuando el usuario pulsa Aceptar<\/strong> (o valida la ventana de alguna otra forma) el c\u00f3digo contin\u00faa ejecut\u00e1ndose.<\/p>\n\n\n\n Si intentas leer los valores antes de ejecutar exec_()<\/code>, normalmente obtendr\u00e1s campos vac\u00edos o valores predeterminados.<\/p>\n\n\n\n \nEl usuario debe completar la ventana y validarla antes de que el plugin pueda acceder de forma fiable a los datos introducidos.<\/p>\n<\/blockquote>\n\n\n\n Este es uno de los conceptos m\u00e1s importantes cuando se trabaja con di\u00e1logos Qt.<\/p>\n\n\n\n La ventana recopila informaci\u00f3n del usuario.<\/p>\n\n\n\n Tu c\u00f3digo recupera esa informaci\u00f3n \u00fanicamente despu\u00e9s de que la ventana haya sido validada.<\/p>\n\n\n\n \n\n\n\n<\/span>Una forma sencilla de entenderlo<\/span><\/h2>\n\n\n\nPuedes imaginar una ventana de di\u00e1logo como un formulario que espera ser completado.<\/p>\n\n\n\n El proceso siempre sigue la misma secuencia:<\/p>\n\n\n\n \nEl plugin muestra la ventana.<\/li>\n\n\n\n El usuario introduce informaci\u00f3n.<\/li>\n\n\n\n El usuario pulsa Aceptar<\/strong>.<\/li>\n\n\n\n El plugin recupera los valores.<\/li>\n\n\n\n El plugin ejecuta una acci\u00f3n.<\/li>\n<\/ol>\n\n\n\nSi uno de estos pasos falta, el proceso queda incompleto.<\/p>\n\n\n\n Comprender esta secuencia facilita enormemente entender c\u00f3mo interact\u00faan los plugins QGIS con sus usuarios.<\/p>\n\n\n\n \n\n\n\n<\/span>Ejemplo completo m\u00ednimo<\/span><\/h2>\n\n\n\nVamos a reunir todos los elementos en un ejemplo sencillo y deliberadamente minimalista.<\/p>\n\n\n <\/div><\/div><\/div><\/div><\/p>\nresult = self.dlg.exec_()<\/p>\n if result: \ntexto = self.dlg.lineEdit.text() \nopcion = self.dlg.comboBox.currentText() \nactivo = self.dlg.checkBox.isChecked()<\/p>\n print(\"Texto:\", texto)\nprint(\"Opci\u00f3n:\", opcion)\nprint(\"Opci\u00f3n activa:\", activo)\n<\/code><\/pre>\n<\/div><\/div>\n\n\n\n En este punto, el plugin no realiza:<\/p>\n\n\n\n \nning\u00fan an\u00e1lisis,<\/li>\n\n\n\n ning\u00fan procesamiento complejo,<\/li>\n\n\n\n ninguna interacci\u00f3n con capas QGIS.<\/li>\n<\/ul>\n\n\n\nEl objetivo es simplemente demostrar que el plugin puede recuperar correctamente la informaci\u00f3n introducida por el usuario.<\/p>\n\n\n\n Una vez que logras hacerlo, ya has establecido la conexi\u00f3n entre la interfaz gr\u00e1fica y el c\u00f3digo Python.<\/p>\n\n\n\n Y eso representa un paso muy importante en el desarrollo de plugins.<\/p>\n\n\n\n \n\n\n\n<\/span>\u00bfPor qu\u00e9 no ocurre nada si no lees los valores?<\/span><\/h2>\n\n\n\nEsta es una de las preguntas m\u00e1s frecuentes entre quienes empiezan.<\/p>\n\n\n\n Un plugin QGIS no es un formulario autom\u00e1tico.<\/p>\n\n\n\n No existe ninguna magia oculta detr\u00e1s de la interfaz.<\/p>\n\n\n\n Cuando un usuario escribe un texto, selecciona una opci\u00f3n o marca una casilla, QGIS simplemente almacena esa informaci\u00f3n dentro del widget correspondiente.<\/p>\n\n\n\n Si tu c\u00f3digo nunca recupera ese valor, dicho valor nunca se utilizar\u00e1.<\/p>\n\n\n\n No ocurre nada porque el plugin no ha recibido ninguna instrucci\u00f3n sobre qu\u00e9 hacer con la informaci\u00f3n introducida.<\/p>\n\n\n\n Este comportamiento es intencionado.<\/p>\n\n\n\n Permite al desarrollador tener un control total sobre el comportamiento del plugin y sobre las acciones que deben ejecutarse.<\/p>\n\n\n\n \n Los datos introducidos por el usuario solo se vuelven \u00fatiles cuando tu c\u00f3digo los recupera y los utiliza expl\u00edcitamente.<\/p>\n<\/blockquote>\n\n\n\n <\/span>Lo que has aprendido<\/span><\/h2>\n\n\n\nAl finalizar este art\u00edculo, ya sabes:<\/p>\n\n\n\n \nd\u00f3nde se almacenan los valores introducidos por el usuario;<\/li>\n\n\n\n c\u00f3mo recuperarlos en Python;<\/li>\n\n\n\n cu\u00e1ndo deben recuperarse;<\/li>\n\n\n\n por qu\u00e9 no ocurre nada hasta que el plugin utiliza esos valores expl\u00edcitamente.<\/li>\n<\/ul>\n\n\n\nEstos conceptos constituyen la base de cualquier plugin QGIS interactivo.<\/p>\n\n\n\n Tanto si tu plugin realiza un c\u00e1lculo sencillo como un an\u00e1lisis espacial complejo, casi siempre comenzar\u00e1 recopilando informaci\u00f3n del usuario.<\/p>\n\n\n\n \n\n\n\n<\/span>\u00bfQu\u00e9 veremos en el pr\u00f3ximo art\u00edculo?<\/span><\/h2>\n\n\n\nHasta ahora, nuestro plugin es capaz de recuperar la informaci\u00f3n introducida por el usuario.<\/p>\n\n\n\n Sin embargo, todav\u00eda no hace nada \u00fatil con ella.<\/p>\n\n\n\n En el pr\u00f3ximo art\u00edculo veremos c\u00f3mo transformar esos datos en acciones concretas.<\/p>\n\n\n\n Aprenderemos a:<\/p>\n\n\n\n \nvalidar los datos introducidos;<\/li>\n\n\n\n aplicar reglas de negocio;<\/li>\n\n\n\n tomar decisiones en funci\u00f3n de las elecciones del usuario;<\/li>\n\n\n\n controlar el comportamiento del plugin.<\/li>\n<\/ul>\n\n\n\n\n Recuperar los valores es el primer paso.<\/p>\n<\/blockquote>\n\n\n\n Utilizarlos de forma inteligente es lo que convierte un plugin en una herramienta realmente \u00fatil.<\/p>\n\n\n\n \n\n\n\nArt\u00edculo siguiente:<\/strong> Desarrollar un Plugin QGIS: Aplicar L\u00f3gica de Negocio a los Datos Introducidos por el Usuario<\/em><\/p>\n\n\n\n \n","protected":false},"excerpt":{"rendered":"Cuando se empieza a desarrollar plugins para QGIS, es frecuente pensar que un bot\u00f3n deber\u00eda \u201chacer algo\u201d por s\u00ed solo. En realidad, un bot\u00f3n no hace absolutamente nada… hasta que le indicamos qu\u00e9 debe hacer. En…<\/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":[3442,1357],"tags":[4155,4700,4746,4748,4750,4752,4754,4744],"class_list":["post-16863","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-pluigin-es","category-qgis-es","tag-desarrollo-de-plugins-qgis","tag-pyqgis-es","tag-qcheckbox-fr-es","tag-qcombobox-fr-es","tag-qlineedit-fr-es","tag-qspinbox-fr-es","tag-qt-designer-fr-es","tag-ventana-qgis"],"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