blob: e451abf399f5b68670f3ac5eeb429ff69cec1e19 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<meta name="author" content="alexey.vladykin@sun.com">
<meta name="description" content="A short guide to working with Qt applications in NetBeans IDE or
Oracle Solaris Studio IDE.">
<meta name="keywords" content="NetBeans, Oracle Solaris Studio, IDE, Qt application,
tutorial, guide, user, documentation, open source, C, C++, make, dbx, gdb">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" >
<link rel="stylesheet" type="text/css" href="../../../netbeans.css">
<title>Trabalhando com Aplicações Qt - Tutorial do NetBeans IDE</title>
</head>
<body style="padding: 2px;">
<h1>Trabalhando com Aplicações Qt - Tutorial do NetBeans IDE</h1>
<div class="articledate" style="margin-left: 0px;font-style:italic;">
<p><em>Contribuição de <i>Alexey Vladykin</i></a> e mantida por <a href="mailto:susan.morgan@oracle.com"><i>Susan Morgan</i><br>Outubro de 2013</em> [Número da versão: V7.4-1]</div>
<p>Este tutorial vai orientá-lo durante a criação de um projeto de aplicação Qt simples no NetBeans IDE. A origem Qt Toolkit é uma plataforma cruzada do framework de desenvolvimento de aplicação.</p>
<p><b>Conteúdo</b></p>
<img alt="O conteúdo desta página se aplica ao NetBeans IDE 6.8, 6.9, 7.3 e 7.4" class="stamp" src="../../../images_www/articles/73/netbeans-stamp-74-73.png" title="O conteúdo desta página se aplica ao NetBeans IDE 7.3 e 7.4">
<ul class="toc">
<li><a href="#requirements">Requisitos</a></li>
<li><a href="#intro">Introdução</a></li>
<li><a href="#qtinstall">Instalando o Software Qt 4</a></li>
<li><a href="#creating">Criando uma Aplicação Qt Simples</a></li>
<li><a href="#conclusion">Conclusão</a></li>
</ul>
<h2><a NAME="requirements"></a>Requisitos</h2>
<p><b>Para seguir este tutorial, você precisa do software a seguir.</b></p>
<table>
<tbody>
<tr>
<th class="tblheader" scope="col">Software</th>
<th class="tblheader" scope="col">Versão Necessária</th>
</tr>
<tr>
<td class="tbltd1"><a href="https://netbeans.org/downloads/index.html">NetBeans IDE</a> (incluindo o suporte ao C/C++)</td>
<td class="tbltd1">versão 7.3 ou 7.4 do NetBeans com o plug-in C/C++</td>
</tr>
<tr>
<td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">Java Development Kit</a> (JDK)</td>
<td class="tbltd1">Versão 7</td>
</tr>
<tr>
<td class="tbltd1"><a href="../../../community/releases/74/cpp-setup-instructions.html">Compiladores C/C++ GNU (GCC)</a></td>
<td class="tbltd1">Versões suportadas pelo NetBeans IDE. <br>No Windows, o MinGW é obrigatório. </td>
</tr>
<tr>
<td class="tbltd1"><a href="#qtinstall">Bibliotecas Qt</a></td>
<td class="tbltd1">Versão 4.8 <br>Observe que Qt 5 não trabalha com este tutorial</td>
</tr><tr><td>
</tr>
</tbody>
</table>
<br>
<p>Consulte as <a href="../../../community/releases/74/install.html">Instruções de Instalação do NetBeans IDE</a> para obter informações sobre o download e a instalação do software NetBeans requerido.
</p>
<h2><a name="intro"></a>Introdução</h2>
<P>O NetBeans IDE suporta a criação, construção, execução e depuração de projetos Qt sem deixar o IDE. As ferramentas Qt como qmake, moc e uic são iniciadas automaticamente conforme o necessário. Não é necessário conhecê-las nem saber nada sobre elas. Este artigo mostra como configurar o NetBeans IDE para usar o Qt 4.8 e criar uma aplicação Qt simples. </P>
<h2><a name="qtinstall"></a>Instalando o Software Qt para Uso no NetBeans IDE</h2>
<p>Você deve instalar o software Qt e configurar o NetBeans para usá-lo antes de criar aplicações do Qt no IDE. </p>
<p class="notes"><strong>Importante: é necessário usar o Qt 4.8 para seguir este tutorial.<br><br> Se quiser usar Qt 5, consulte este artigo: <br> <a href="http://wiki.netbeans.org/Talk:HowToSetup64-BitQt5WithNetBeans7.4OnWindows"> Como Configurar o Qt 5 de 64 Bits com o NetBeans 7.4 no Windows</a></strong><br> </p>
<p>Consulte as instruções para configurar o Qt para sua plataforma:</p>
<ul type="disc">
<li><a href="#setupwin">Configurando o Qt para NetBeans IDE no Windows</a></li>
<li><a href="#setuplinmac">Configurando Qt para NetBeans IDE em Plataformas Linux ou Mac OS X</a></li>
<li><a href="#setupsolaris">Configurando o Qt para NetBeans IDE nas Plataformas Solaris</a></li>
</ul>
<h3><a name="setupwin"></a>Configurando o Qt 4.8 para NetBeans IDE no Windows</h3>
<p>Estas instruções descrevem o software que foi instalado no Windows para criar este tutorial. </p>
<h4>Faça Download do Software Necessário para Windows</h4>
<ol>
<li>Instale o NetBeans IDE e o módulo de plug-in C/C++, como explicado em <a href="../../../community/releases/74/cpp-setup-instructions.html"> Configurando o NetBeans IDE para C/C++/Fortran</a>. Não instale compiladores ainda.</li>
<li>Saia do NetBeans IDE.</li>
<li>Efetue download do instalador do MinGW em <a href="http://sourceforge.net/projects/mingw">http://sourceforge.net/projects/mingw</a>.</li>
<li>Execute o instalador do MinGW, que deve ter um nome de arquivo semelhante a <tt>mingw-get-inst-20120426.exe</tt>.</li>
<li>No instalador do MinGW, selecione os seguintes componentes para instalação:
<ul><li>C</li>
<li>C++</li>
<li>Sistema Básico MSYS</li>
<li>Kit de Ferramentas para Desenvolvedor do MinGW</li>
</ul>
O instalador leva alguns momentos para fazer download e extrair os pacotes de software. Por padrão, o MinGW é instalado no <tt>C:\MinGW</tt>.</li>
<li>Faça download do software Qt de <a href="http://qt-project.org/downloads">http://qt-project.org/downloads</a> e instale-o. <br>
<ul><li>Bibliotecas de Qt 4.8.5 para Windows (minGW 4.4 317 MB) </li>
<li>Criador do Qt 2.8.1 para Windows (51 MB) </li></ul>
</ol>
<h4>Edite o Caminho para o Windows</h4>
<p>É necessário editar a variável de ambiente PATH no Windows para adicionar os caminhos aos binários para Qt, MinGW e MSYS. Se você tiver instalado com o default, os caminhos são:</p>
<ul>
<li><tt>C:\Qt\4.8.5\bin</tt></li>
<li><tt>C:\MinGW\bin</tt></li>
<li><tt>C:\MinGW\MSYS\1.0\bin</tt></li>
</ul>
<p><b>Para adicionar os caminhos à sua variável de caminho do ambiente:</b></p>
<ol>
<li>Abra a janela Variáveis de Ambiente:
<ul>
<li>No Windows XP e Windows 2000: clique com o botão direito do mouse em Meu Computador > Propriedades > guia Avançadas > botão Variáveis do Ambiente.</li>
<li>No Windows Vista e Windows 7: clique com o botão direito do mouse em Meu Computador > Propriedades > link Configurações Avançadas do Sistema > botão Variáveis do Ambiente.</li></ul>
<li>Na janela Variáveis do Ambiente, selecione a variável Path na seção Variáveis do Sistema e clique em Editar.</li>
<li>No final do caminho, insira um ponto-e-vírgula e adicione os caminhos até os executáveis para Qt, MinGW e MSYS. Use pontos-e-vírgulas entre os caminhos e não use nenhum espaço. Tenha cuidado para não remover nada do PATH ou seu computador pode não funcionar corretamente. <br>
<p>Quando terminar, o caminho deve ser semelhante ao seguinte:</p>
<pre>%SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\Wbem;
%SYSTEMROOT%\System32\WindowsPowerShell\v1.0;C:\MinGW\bin;C:\MinGW\MSYS\1.0\bin;C:\Qt\4.8.5\bin</pre>
</li>
<li>Clique em OK na janela Variáveis do Ambiente.</li>
</ol>
<h4>Criar um Conjunto de Ferramentas para MinGW e Qt</h4>
<p>Você deve criar um novo conjunto de ferramentas que use compiladores MinGW, os comandos de MSYS e comandos do Qt.</p>
<p><b>Para criar um novo conjunto de ferramentas:</b></p><ol>
<li>Inicie o NetBeans IDE e abra a janela Serviços escolhendo Janela > Serviços.
<li>Expanda o nó Hosts da Compilação C/C++, clique com o botão direito do mouse no nó Conjunto de Ferramentas e selecione Adicionar Novo Grupo de Ferramentas.<br><br> <img alt="Tela da opção Adicionar Novo Conjunto de Ferramentas" class="b-all margin-around" src="../../../images_www/articles/73/cnd/qt/qt-addtool.png"></li>
<li>Especifique o diretório de instalação bin MinGW como o diretório de base de conjunto de ferramentas (por exemplo, <tt>C:\mingw\bin</tt>). <br> A Família do Conjunto de Ferramentas e o Nome do Conjunto de Ferramentas deverão ser preenchidos automaticamente em um MinGW.
</li>
<li>Altere o Nome do Conjunto de Ferramentas para MinGW_Qt e clique em OK.<br>
</li>
<li>Clique com o botão direito do mouse no novo conjunto de ferramentas MinGW_Qt, no nó Conjunto de Ferramentas, na janela Serviços, e selecione Propriedades. <br>Os caminhos para as ferramentas devem ser semelhantes à imagem a seguir. <br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-toolpaths.png" alt="Tela mostrando caminhos de ferramenta o MinGW." class="margin-around">
</li>
<li>Verifique os comandos para o Comando Make e o Comando QMake e corrija-os, se necessário.<br> O comando Make deve ser <tt>C:\MinGW\MSYS\1.0\bin\make.exe</tt> e o comando QMake deve ser <tt>C:\Qt\4.8.5\bin\qmake.exe</tt>.</li>
<li>Clique no botão Default enquanto MinGW_Qt é selecionado para torná-lo o conjunto de ferramentas default.</li>
<li>Prosseguir para <a href="#creating">Criando uma Aplicação Qt Simples</a> neste artigo.</li>
</ol>
<h3><a name="setuplinmac"></a>Configurando Qt para NetBeans IDE em Plataformas Linux ou Mac OS X</h3>
<ol><li>Faça download das bibliotecas de Qt para sua plataforma Linux ou Mac OS X em <a href="http://qt-project.org/downloads" target="_blank">http://qt-project.org/downloads</a> ou obtenha-as no repositório do pacote Linux.</li>
<li>Se os compiladores ainda não estiverem presentes no seu sistema, instale-os como explicado em <a href="../../../community/releases/74/cpp-setup-instructions.html">Configurando o NetBeans IDE para C/C++/Fortran</a>. </li>
<li>Adicione os caminhos para os compiladores e ferramentas de Qt para sua variável de caminho PATH</li>
<li>Em uma janela de terminal, digite <tt>qmake -v</tt> e <tt>gcc --version</tt> para verificar se os comandos estão no seu caminho.</li>
<li>Quando as ferramentas estiverem disponíveis na linha de comando, inicie o NetBeans IDE e verifique as propriedades dos Conjuntos de Ferramentas para conferir se os caminhos para compiladores, comando make e comando qmake estão corretos.</li>
<li>Prosseguir para <a href="#creating">Criando uma Aplicação Qt Simples</a> neste artigo.</li>
</ol>
<h3><a name="setupsolaris"></a>Configurando o Qt para NetBeans IDE nas Plataformas Oracle Solaris</h3>
<p>Binários para Qt não estão disponíveis para plataformas Oracle Solaris. No entanto, é possível criar o Qt da compilação da origem e usá-la com o NetBeans IDE.
</p>
<ol>
<li>Instale seus compiladores como explicado em <a href="../../../community/releases/74/cpp-setup-instructions.html"> Configurando o NetBeans IDE para C/C++/Fortran</a>. </li>
<li>Faça download da fonte do Qt em <a href="ftp://ftp.qt-project.org/qt/source/">ftp://ftp.qt-project.org/qt/source/</a></li>
<li>Consulte a documentação do Qt <a href="http://qt-project.org/doc/qt-4.8/install-X11.html">Instalando Qt para Plataformas X11</a> para obter instruções de compilação.</li>
<li>Depois de compilar com sucesso os binários de Qt, edite sua variável de ambiente PATH para adicionar o caminho aos binários de Qt.</li>
<li>Em uma janela de terminal, digite <tt>qmake -v</tt> e <tt>gcc --version</tt> para verificar se os comandos estão no seu caminho.</li>
<li>Quando os compiladores GNU e as ferramentas Qt estiverem disponíveis na linha de comando, inicie o NetBeans IDE. </li>
<li>Verifique as propriedades dos Conjuntos de Ferramentas para conferir se os caminhos para os compiladores e comando qmake estão corretos.</li>
<li>Prosseguir para <a href="#creating">Criando uma Aplicação Qt Simples</a> neste artigo.</li>
</ol>
<H2><a name="creating"></a>Criando uma Aplicação Qt Simples</H2>
<P>Neste tutorial, você criará uma aplicação Qt simples "Hello World", similar à amostra Hello Qt World, que pode ser encontrado em Amostras->C/C++->Hello Qt World.</P>
<p>Estas instruções foram escritas para plataformas Windows. Usuários de plataformas Mac, Linux e Solaris podem executar as mesmas etapas usando um conjunto de ferramentas GNU em que o caminho para <tt>qmake</tt> seja especificado corretamente.
<ol>
<li>Primeiro, crie um novo projeto. Selecione Aplicação Qt C/C++ na caixa de diálogo Novo Projeto e clique em Próximo.<br> <img alt="Nova caixa de diálogo do projeto" class="b-all margin-around" src="../../../images_www/articles/73/cnd/qt/qt-create-new-project.png">
</li>
<li>Na caixa de diálogo, altere o nome e a localização do projeto se for necessário.
<p>Marque Criar Arquivo Principal e selecione o conjunto de ferramentas MinGW_qt. Em seguida, clique em Finalizar</p>
<img alt="Caixa de diálogo do projeto Nova Qt" class="b-all margin-around" src="../../../images_www/articles/73/cnd/qt/qt-create-main-file.png">
<p>A aparência do novo projeto deve ser semelhante a esta:</p>
<img alt="Projeto Qt e arquivo main.cpp" class="b-all margin-around" src="../../../images_www/articles/73/cnd/qt/qt-app-maincpp.png">
</li>
<li>Clique com o botão direito do mouse no nó do projeto e selecione Propriedades para abrir a caixa de diálogo Propriedades do Projeto. Clique na categoria Qt. Usuários avançados podem ajustar muitos elementos nas propriedades de projeto do Qt, mas, para este tutorial, deixe tudo como está.<br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-project-properties.png" alt="Caixa de diálogo propriedades do projeto Qt" class="b-all margin-around">
</li>
<li>Clique na categoria Executar e defina a propriedade Tipo de Console para o Terminal Externo e clique em OK.</li>
<li>Em seguida, você pode criar um form. Clique com o botão direito do mouse em Arquivos de Recurso e selecione Novo->Form Qt.<br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-app-resource-files.png" alt="Adicionando arquivos de recurso para o projeto Qt" class="b-all margin-around">
</li>
<li>Na caixa de diálogo Form Qt, digite <b>HelloForm</b> em Nome do form e selecione Caixa de diálogo sem Botões em Tipo de Form. Marque Criar Classe de Encapsulador C++ e clique em Finalizar.<br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-new-form.png" alt="form novo Qt" class="b-all margin-around">
<p>São criados três arquivos (<tt>HelloForm.ui</tt>, <tt>HelloForm.cpp</tt>, <tt>HelloForm.h</tt>) e o IDE abre automaticamente o Qt Designer para que você edite o novo form (<tt>HelloForm.ui</tt>).</p>
<img SRC="../../../images_www/articles/73/cnd/qt/qt-designer.png" alt="Qt Designer abre automaticamente" class="b-all margin-around">
</li>
<li>Use seus conhecimentos sobre GUI para criar um form semelhante ao exibido abaixo. Adicione ao novo form dois widgets do QLineEdit e altere o nome do primeiro widget para <tt>nameEdit</tt> e o do segundo widget para <tt>helloEdit</tt>.<br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-designer-form.png" alt="Designer Qt com o form criado" class="b-all margin-around">
</li>
<li>Ao finalizar a criação do form, salve-o e feche o Qt Designer. O projeto tem a aparência mostrada na figura. <br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-hello-form.png" alt="Arquivo do código-fonte do form Hello" class="b-all margin-around"> <br>
<P>Todos os arquivos HelloForm recém-criados são colocados na mesma pasta lógica Arquivos de Recurso. Se você preferir ter CPP arquivos nos arquivos de origem e arquivos H nos Arquivos do Cabeçalho -, arraste e solte-os para a pasta de lógica desejada.</P>
<P>Você deverá ver um pequeno ponto de interrogação na guia Projetos para indicar a presença de diretivas <tt>#include</tt> interrompidas. O <tt>setupUi</tt> sublinhado em verde é uma consequência da diretiva <tt>#include ui_HelloForm.h</tt> interrompida, o que ocorre no arquivo <tt>HelloForm.h</tt>. O arquivo de inclusão <tt>ui_HelloForm.h</tt> ainda não existe realmente e será gerado com a primeira compilação do projeto. É assim que funciona o sistema de construção do Qt. </P>
</li>
<li>Clique no botão Compilar Projeto na barra de ferramentas e o erro deverá desaparecer quando o arquivo <tt>ui_HelloForm.h</tt> for gerado.</li>
<li>Abra <tt>main.cpp</tt> e insira duas linhas de código responsáveis pela criação e exibição do HelloForm, como mostrado nas linhas 17 e 18 da figura abaixo. Não esqueça de incluir <tt>HelloForm.h</tt>, como mostrado na linha 9.<br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-hello-form-edit.png" alt="Editando o form Hello arquivos de origem" class="b-all margin-around">
</li>
<li>Clique no botão Executar na barra de ferramentas para executar a aplicação.<br> Primeiro, você verá uma janela de terminal e depois a caixa de diálogo que você criou no Qt Designer.</li>
<li>Digite algo no campo de texto e pressione Enter e você deverá ver que nada ocorre.
<P>Para permitir que a aplicação responda, você deverá definir um slot e conectá-lo a um sinal <tt>textChanged</tt> acionado pelo campo de texto. Para aprender mais sobre sinais e slots Qt leia <a HREF="http://doc.qt.digia.com/4.6/signalsandslots.html" TARGET="_blank">http://doc.qt.digia.com/4.6/signalsandslots.html</a></P>
</li>
<li>Vá para <tt>HelloForm.h</tt> e declare esse slot como mostrado nas linhas 18 e 19 na seguinte figura:<br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-hello-form-h.png" alt="Editando o arquivo de inclusão do form Hello" class="b-all margin-around">
</li>
<li>Em seguida, vá para <tt>HelloForm.cpp</tt> e insira a definição de slot como mostrado nas linhas 17 a 23 da seguinte figura:<br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-hello-form-slot.png" alt="Adicionar Slot para formar os arquivos de código-fonte" class="b-all margin-around">
</li>
<li>Finalmente, conecte o sinal com o slot inserindo código no construtor HelloForm, como mostrado nas linhas 12 e 13 da seguinte figura:<br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-hello-form-cpp.png" alt="Adicionar Slot ao construtor do form Hello" class="b-all margin-around">
</li>
<li>Agora, execute a aplicação e, quando a caixa de diálogo for exibida, clique no campo de entrada superior, digite seu nome e o campo inferior irá refletir Hello para você, como mostrado abaixo.<br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-app-running.png" alt="Qt Hello World APP em execução" class="b-all margin-around">
</li>
</ol>
<H2><a name="conclusion"></a>Conclusão</H2>
<p>Este artigo mostrou como configurar seu ambiente para você usar o NetBeans IDE com bibliotecas e ferramenta Qt.</p>
<P>Crie e desenvolva aplicações Qt com o NetBeans e envie seu feedback para a <a HREF="mailto:users@cnd.netbeans.org">lista de endereços CND </a> e para o <a href="https://forums.netbeans.org/cnd-users.html">fórum do Usuário do NetBeans C/C++</a>.</P>
<P>Encontrou um erro ou deseja sugerir uma melhoria? Arquive-os em <a HREF="https://netbeans.org/bugzilla/enter_bug.cgi?component=cnd">https://netbeans.org/bugzilla/enter_bug.cgi?component=cnd</a> (registro netbeans.org requerido)</P>
<h2>Consulte Também</h2>
<p>Consulte a <a href="https://netbeans.org/kb/trails/cnd.html">Trilha do Aprendizado C/C++</a> para obter mais artigos sobre o desenvolvimento com C/C++/Fortran no NetBeans IDE.</p>
<div class="feedback-box"><a href="mailto:users@cnd.netbeans.org?subject=Feedback:%20Working%20with%20Qt%20Applications%20-%20NetBeans%20IDE%207.4%20Tutorial">Enviar Feedback neste Tutorial</a></div>
<br style="clear: both;">
</BODY>
</HTML>