{"id":16387,"date":"2026-06-11T12:00:00","date_gmt":"2026-06-11T10:00:00","guid":{"rendered":"https:\/\/www.sigterritoires.fr\/?p=16387"},"modified":"2026-06-11T11:35:34","modified_gmt":"2026-06-11T09:35:34","slug":"desenvolver-plugin-qgis-adicionar-botao-janela","status":"publish","type":"post","link":"https:\/\/www.sigterritoires.fr\/index.php\/pt\/desenvolver-plugin-qgis-adicionar-botao-janela\/","title":{"rendered":"[PT]Desenvolver um Plugin QGIS: Adicionar um Bot\u00e3o e uma Janela"},"content":{"rendered":"\n

\n\n\n\n

Adicionar um bot\u00e3o \u00e0 interface do QGIS costuma ser o primeiro passo concreto no desenvolvimento de um plugin. \u00c9 isso que transforma um simples script em Python em uma ferramenta realmente utiliz\u00e1vel pelo usu\u00e1rio.<\/p>\n\n\n\n

Neste terceiro artigo do tutorial, veremos como adicionar um bot\u00e3o e exibir uma janela em um plugin QGIS, com base no c\u00f3digo gerado pelo Plugin Builder. Vamos dedicar um tempo para compreender os elementos essenciais: o m\u00e9todo initGui()<\/code>, as a\u00e7\u00f5es (QAction<\/code>) e o acionamento do di\u00e1logo.<\/p>\n\n\n\n

Este tutorial \u00e9 voltado para iniciantes no desenvolvimento de plugins QGIS que desejam entender como interagir com a interface do QGIS antes de avan\u00e7ar para a l\u00f3gica de neg\u00f3cio.<\/p>\n\n\n\n

\n\n\n\n\n\n\n
\n\n\n\n\n\nContenu <\/p>\nToggle<\/span>
Adicionar um bot\u00e3o e exibir uma janela no QGIS<\/a><\/li>
Lembrete: o plugin gerado pelo Plugin Builder<\/a><\/li>
O arquivo principal do plugin<\/a><\/li>
O m\u00e9todo initGui(): ponto de entrada visual<\/a><\/li>
O m\u00e9todo run(): quando o bot\u00e3o \u00e9 clicado<\/a><\/li>
📦 O que um bot\u00e3o faz de verdade no QGIS<\/a><\/li>
Entendendo a janela (di\u00e1logo)<\/a><\/li>
Modificar o texto da janela<\/a><\/li>
Testar e recarregar o plugin<\/a><\/li>
Erros frequentes nesta etapa<\/a><\/li>
O que voc\u00ea aprendeu<\/a><\/li>
E no pr\u00f3ximo artigo?<\/a><\/li><\/ul><\/nav><\/div>\n<\/span>Adicionar um bot\u00e3o e exibir uma janela no QGIS<\/span><\/h2>\n\n\n\nNos dois primeiros artigos, estabelecemos as bases: entender o que \u00e9 um plugin QGIS e criar um plugin vazio usando o Plugin Builder. Agora \u00e9 hora de dar um comportamento vis\u00edvel ao nosso plugin.<\/p>\n\n\n\n
Neste artigo, vamos aprender a:<\/p>\n\n\n\n
\nadicionar um bot\u00e3o \u00e0 interface do QGIS,<\/li>\n\n\n\n
compreender o c\u00f3digo gerado pelo Plugin Builder,<\/li>\n\n\n\n
exibir uma janela (di\u00e1logo) simples.<\/li>\n<\/ul>\n\n\n\nO objetivo ainda n\u00e3o \u00e9 fazer algo complexo, mas entender o mecanismo fundamental de qualquer plugin QGIS.<\/p>\n\n\n\n
\n\n\n\n<\/span>Lembrete: o plugin gerado pelo Plugin Builder<\/span><\/h2>\n\n\n\nQuando escolhemos o template Tool button with dialog<\/strong>, o Plugin Builder j\u00e1 preparou muita coisa para n\u00f3s:<\/p>\n\n\n\n
\num bot\u00e3o na barra de ferramentas,<\/li>\n\n\n\n
um item de menu no QGIS,<\/li>\n\n\n\n
uma janela gr\u00e1fica associada.<\/li>\n<\/ul>\n\n\n\nMesmo que tudo isso j\u00e1 funcione, \u00e9 essencial entender como esses elementos est\u00e3o conectados.<\/p>\n\n\n\n
\n\n\n\n<\/span>O arquivo principal do plugin<\/span><\/h2>\n\n\n\nAbra o arquivo Python principal do seu plugin (por exemplo mon_premier_plugin.py<\/code>).<\/p>\n\n\n\n
Voc\u00ea encontrar\u00e1 uma classe principal com o nome do plugin. \u00c9 ela que controla todo o comportamento.<\/p>\n\n\n\n
class MonPremierPlugin:\n    def __init__(self, iface):\n        self.iface = iface\n<\/code><\/pre>\n\n\n\n👉 iface<\/code> \u00e9 o objeto que permite ao plugin dialogar com o QGIS (menus, camadas, mensagens\u2026).<\/p>\n\n\n\n
\n\n\n\n<\/span>O m\u00e9todo initGui()<\/code>: ponto de entrada visual<\/span><\/h2>\n\n\n\nO m\u00e9todo initGui()<\/code> \u00e9 chamado automaticamente quando o plugin \u00e9 ativado no QGIS.<\/p>\n\n\n\n
\u00c9 aqui que s\u00e3o definidos:<\/p>\n\n\n\n
\no bot\u00e3o na barra de ferramentas,<\/li>\n\n\n\n
a entrada no menu,<\/li>\n\n\n\n
a a\u00e7\u00e3o associada.<\/li>\n<\/ul>\n\n\n\nExemplo t\u00edpico:<\/p>\n\n\n\n
def initGui(self):\n    self.action = QAction(\n        QIcon(':\/plugins\/MonPremierPlugin\/icon.png'),\n        'Meu primeiro 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\nMesmo sem entender cada linha em detalhe, guarde o essencial:<\/p>\n\n\n\n
\numa a\u00e7\u00e3o \u00e9 criada,<\/li>\n\n\n\n
ela \u00e9 conectada a um m\u00e9todo (run<\/code>),<\/li>\n\n\n\n
ela \u00e9 adicionada \u00e0 interface do QGIS.<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n<\/span>O m\u00e9todo run()<\/code>: quando o bot\u00e3o \u00e9 clicado<\/span><\/h2>\n\n\n\nO m\u00e9todo run()<\/code> \u00e9 chamado quando o usu\u00e1rio clica no bot\u00e3o do plugin.<\/p>\n\n\n\n
No template gerado, ele serve principalmente para exibir uma janela.<\/p>\n\n\n\n
def run(self):\n    self.dlg.show()\n<\/code><\/pre>\n\n\n\n👉 Neste est\u00e1gio, o plugin faz apenas uma coisa: abrir um di\u00e1logo.<\/p>\n\n\n\n
\n\n\n\n<\/span>📦 O que um bot\u00e3o faz de verdade no QGIS<\/span><\/h2>\n\n\n\nQuando clicamos em um bot\u00e3o no QGIS, nada \u201cm\u00e1gico\u201d acontece.<\/p>\n\n\n\n
Um bot\u00e3o de plugin \u00e9 simplesmente um gatilho: ele chama uma fun\u00e7\u00e3o Python espec\u00edfica.<\/p>\n\n\n\n
Concretamente, o funcionamento \u00e9 sempre o mesmo:<\/p>\n\n\n\n
\no plugin cria uma a\u00e7\u00e3o (QAction<\/code>),<\/li>\n\n\n\n
essa a\u00e7\u00e3o \u00e9 associada a uma fun\u00e7\u00e3o (por exemplo run()<\/code>),<\/li>\n\n\n\n
quando o usu\u00e1rio clica no bot\u00e3o, o QGIS executa essa fun\u00e7\u00e3o.<\/li>\n<\/ul>\n\n\n\nNo nosso caso, a fun\u00e7\u00e3o run()<\/code> apenas exibe uma janela. Mais adiante, essa mesma fun\u00e7\u00e3o poder\u00e1:<\/p>\n\n\n\n
\nler par\u00e2metros informados pelo usu\u00e1rio,<\/li>\n\n\n\n
analisar camadas,<\/li>\n\n\n\n
executar processamentos,<\/li>\n\n\n\n
produzir resultados.<\/li>\n<\/ul>\n\n\n\n👉 Um bot\u00e3o no QGIS faz apenas uma coisa: executar c\u00f3digo Python.
Todo o poder do plugin est\u00e1 nesse c\u00f3digo.<\/p>\n\n\n\n
\n\n\n\n<\/span>Entendendo a janela (di\u00e1logo)<\/span><\/h2>\n\n\n\nA janela exibida \u00e9 definida em um arquivo .ui<\/code>, criado com o Qt Designer.<\/p>\n\n\n\n
Esse arquivo \u00e9 ent\u00e3o carregado em Python, permitindo:<\/p>\n\n\n\n
\nexibir a janela,<\/li>\n\n\n\n
recuperar valores informados pelo usu\u00e1rio,<\/li>\n\n\n\n
conectar bot\u00f5es a c\u00f3digo.<\/li>\n<\/ul>\n\n\n\nPor enquanto, vamos apenas modificar o conte\u00fado visual.<\/p>\n\n\n\n
\n\n\n\n<\/span>Modificar o texto da janela<\/span><\/h2>\n\n\n\nAbra o arquivo .ui<\/code> no Qt Designer.<\/p>\n\n\n\n
Experimente, por exemplo:<\/p>\n\n\n\n
\nmudar o t\u00edtulo da janela,<\/li>\n\n\n\n
alterar um r\u00f3tulo (label),<\/li>\n\n\n\n
adicionar um bot\u00e3o.<\/li>\n<\/ul>\n\n\n\nSalve o arquivo, recarregue o plugin no QGIS e clique no bot\u00e3o.<\/p>\n\n\n\n
👉 Voc\u00ea acabou de modificar a interface de um plugin QGIS sem escrever c\u00f3digo Python.<\/p>\n\n\n\n
\n\n\n\n<\/span>Testar e recarregar o plugin<\/span><\/h2>\n\n\n\nA cada modifica\u00e7\u00e3o no c\u00f3digo ou na interface:<\/p>\n\n\n\n
\ndesative o plugin no gerenciador de extens\u00f5es,<\/li>\n\n\n\n
reative-o,<\/li>\n<\/ul>\n\n\n\nou utilize a op\u00e7\u00e3o Recarregar plugin<\/strong>, se tiver instalado a extens\u00e3o apropriada.<\/p>\n\n\n\n
\n\n\n\n<\/span>Erros frequentes nesta etapa<\/span><\/h2>\n\n\n\n\nnada acontece ao clicar \u2192 m\u00e9todo run()<\/code> n\u00e3o conectado,<\/li>\n\n\n\n
erro ao carregar \u2192 diferen\u00e7a de mai\u00fasculas\/min\u00fasculas nos nomes,<\/li>\n\n\n\n
janela vazia \u2192 arquivo .ui<\/code> mal referenciado.<\/li>\n<\/ul>\n\n\n\nEsses problemas s\u00e3o normais e fazem parte do aprendizado.<\/p>\n\n\n\n
\n\n\n\n<\/span>O que voc\u00ea aprendeu<\/span><\/h2>\n\n\n\nAo final deste artigo, voc\u00ea sabe:<\/p>\n\n\n\n
\nonde o bot\u00e3o de um plugin QGIS \u00e9 criado,<\/li>\n\n\n\n
como uma a\u00e7\u00e3o \u00e9 conectada a c\u00f3digo,<\/li>\n\n\n\n
como exibir e modificar uma janela.<\/li>\n<\/ul>\n\n\n\nAgora voc\u00ea possui o elemento essencial de qualquer plugin QGIS interativo.<\/p>\n\n\n\n
\n\n\n\n<\/span>E no pr\u00f3ximo artigo?<\/span><\/h2>\n\n\n\nNo pr\u00f3ximo artigo, veremos:<\/p>\n\n\n\n
\ncomo recuperar valores digitados na janela,<\/li>\n\n\n\n
como interagir com camadas do QGIS,<\/li>\n\n\n\n
como estruturar o c\u00f3digo para ir mais longe.<\/li>\n<\/ul>\n\n\n\n👉 A partir daqui, seu plugin come\u00e7a a se tornar realmente \u00fatil.<\/p>\n\n\n\n
\n","protected":false},"excerpt":{"rendered":"Adicionar um bot\u00e3o \u00e0 interface do QGIS costuma ser o primeiro passo concreto no desenvolvimento de um plugin. \u00c9 isso que transforma um simples script em Python em uma ferramenta realmente utiliz\u00e1vel pelo usu\u00e1rio. Neste terceiro…<\/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":[3418,2134],"tags":[4214,4216,4652,4101,4218],"class_list":["post-16387","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-pluigin-pt","category-qgis","tag-botao-plugin-qgis","tag-janela-plugin-qgis","tag-plugin-builder-qgis-pt","tag-plugin-qgis-python","tag-pyqgis-tutorial"],"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-4gj","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/posts\/16387","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=16387"}],"version-history":[{"count":0,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/posts\/16387\/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=16387"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/categories?post=16387"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/tags?post=16387"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}