| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> | |
| <!-- | |
| Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved. | |
| --> | |
| <html> | |
| <head> | |
| <title>Assistência de Código no Editor Java do NetBeans IDE: Um Guia de Referência para NetBeans IDE </title> | |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" > | |
| <link rel="stylesheet" type="text/css" href="../../../netbeans.css" media="screen"> | |
| <script src="../../../images_www/js/listCollapse.js" type="text/javascript"></script> | |
| <meta content="?and? 0.5.5" name="GENERATOR"> | |
| <style type="text/css"> | |
| .floatright { | |
| float: right; | |
| margin: 0 0 10px 10px; | |
| border: 1px solid #666; | |
| padding: 2px; | |
| } | |
| .repo { | |
| padding-top: .7em; | |
| line-height: 1.2em; | |
| } | |
| .style1 {font-style: italic} | |
| </style> | |
| </head> | |
| <body> | |
| <h1> | |
| <!-- Begin Content Area --> | |
| <a name="top"></a>Assistência de Código no Editor Java do NetBeans IDE: Um Guia de Referência | |
| </h1> | |
| <p>O propósito do ambiente de desenvolvimento integrado (IDE) é maximizar a produtividade e suportar o desenvolvimento racional usando uma ferramenta única. Este documento de referência descreve as funcionalidades úteis para ajuda na codificação, opções de personalização, e capacidades de navegação do Editor Java do NetBeans IDE.</p> | |
| <p><span class="tips">Assista o screencast <a href="../../../kb/docs/java/java-editor-screencast.html">Editando Código Java no NetBeans IDE </a> para aprender a usar as funcionalidades de produtividade do editor.</span></p> | |
| <h3>Conteúdo</h3> | |
| <img alt="O conteúdo desta página se aplica ao NetBeans IDE 6.9 e versão mais recente" class="stamp" src="../../../images_www/articles/70/netbeans-stamp-70-71-72.gif" title="O conteúdo desta página se aplica ao NetBeans IDE 6.9 e versão mais recente"> | |
| <ul id="collapsableList"> | |
| <li><a href="#codecompletion">Autocompletar Código Inteligente</a> | |
| <ul> | |
| <li><a href="#invoke">Chamando Autocompletar Código</a></li> | |
| <li><a href="#smart">Sugestões Inteligentes no Topo</a></li> | |
| <li><a href="#keywords">Completando Palavras-chave</a></li> | |
| <li><a href="#names">Sugerindo Nomes para Variáveis e Campos</a> </li> | |
| <li><a href="#parameters">Sugerindo Parâmetros</a></li> | |
| <li><a href="#prefix">Conclusão de Prefixo Comum</a></li> | |
| </ul> | |
| </li> | |
| <li><a href="#imports">Gerenciando Importações</a></li> | |
| <li><a href="#generatecode">Gerando Código</a></li> | |
| <li><a href="#codetemplates">Usando Modelos de Código </a></li> | |
| <li><a href="#javadoc">Trabalhando com o Javadoc</a> | |
| <ul> | |
| <li><a href="#display">Exibindo o Javadoc</a> </li> | |
| <li> <a href="#create">Criando Stubs de Javadoc</a></li> | |
| <li> <a href="#hints">Usando Dicas do Javadoc</a></li> | |
| <li><a href="#usecc"> Usando Autocompletar Código para Tags Javadoc </a></li> | |
| <li><a href="#generate-javadoc">Gerando o Javadoc</a></li> | |
| <li><a href="#analyze-javadoc">Analisando o Javadoc</a> </li> | |
| </ul> | |
| </li> | |
| <li><a href="#hints">Usando Dicas</a> | |
| <ul> | |
| <li><a href="#hints-tofix">Usando Dicas para Corrigir o Código</a></li> | |
| <li><a href="#hints-customize">Personalizando Dicas</a></li> | |
| <li><a href="#surround">Circundar com...</a> </li> | |
| </ul> | |
| </li> | |
| <li><a href="#editor-features">Funcionalidades do Editor Geral</a> | |
| <ul> | |
| <li><a href="#formatting">Formatação do Código </a></li> | |
| <li><a href="#braces">Inserindo e Destacando Chaves, Colchetes e Aspas</a></li> | |
| <li><a href="#codefolding">Dobramento de Código</a> </li> | |
| <li><a href="#customizeshortcuts">Personalizando Atalhos do Teclado</a> </li> | |
| </ul> | |
| </li> | |
| <li><a href="#coloring">Coloração e Realces Semânticos</a> | |
| <ul> | |
| <li><a href="#customizecolors">Personalizando Cores</a></li> | |
| <li><a href="#example">Exemplo de Coloração</a></li> | |
| <li><a href="#highlights">Usando Realces</a> </li> | |
| </ul> | |
| </li> | |
| <li><a href="#navigation">Navegação</a> | |
| <ul> | |
| <li><a href="#stripes">Faixas de Erro </a></li> | |
| <li><a href="#goto">Navegando no Editor. Ir para...</a></li> | |
| <li><a href="#lastedit">Saltando para Última Edição</a></li> | |
| <li><a href="#switchfiles">Alternando entre Arquivos</a></li> | |
| <li><a href="#bookmarks">Usando Marcadores</a></li> | |
| <li><a href="#navigator">Usando o Navegador</a> </li> | |
| </ul> | |
| </li> | |
| <li><a href="#appendixa">Apêndice A: Ícones na Janela Autocompletar Código</a></li> | |
| </ul> | |
| <p><b>Para concluir este tutorial, você precisa do software e dos recursos apresentados na tabela a seguir.</b></p> | |
| <table> | |
| <tbody> | |
| <tr> | |
| <th class="tblheader" scope="col">Software ou Recurso</th> | |
| <th class="tblheader" scope="col">Versão Necessária</th> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"><a href="http://netbeans.org/downloads/index.html" target="_blank">NetBeans IDE</a></td> | |
| <td class="tbltd1">versão 6.9 ou posterior </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html" target="_blank">Java Development Kit (JDK)</a></td> | |
| <td class="tbltd1">versão 6 ou 7 </td> | |
| </tr> | |
| </tbody> | |
| </table> | |
| <h2><a name="codecompletion"></a>Autocompletar Código Inteligente</h2> | |
| <p>O Editor Java do NetBeans ajuda a completar e gerar código rapidamente usando a funcionalidade autocompletar código "inteligente". Em um senso geral, o recurso autocompletar código é muito útil quando você deseja preencher o código faltantes, examinar as opções disponíveis no contexto de sua aplicação, e gerar blocos de código quando necessário. Consulte os exemplos abaixo de como usar a opção autocompletar código. </p> | |
| <h3><a name="invoke"></a>Chamando Autocompletar Código</h3> | |
| <table class="full-width colapse"> | |
| <tr> | |
| <td width="43%"> | |
| <img alt="Caixa autocompletar código" src="../../../images_www/articles/73/java/editor-codereference/codecompletion3.png"> </td> | |
| <td width="57%" class="valign-top"><p>Pressione <tt>Ctlr-Espaço</tt> (ou escolha Código-fonte > Autocompletar Código, no menu principal) para abrir a caixa autocompletar código. Na medida em que você digita a lista de sugestões diminui. As sugestões listadas incluem as que estão importadas em seu arquivo de origem e os símbolos do pacote <tt>java.lang</tt>. </p> | |
| <p>Para personalizar as definições de autocompletar código, selecione Ferramentas > Opções > Editor > Autocompletar Código. </p> | |
| <p>Por exemplo, você pode definir que a janela autocompletar código apareça automaticamente ou somente quando necessária. Na guia Autocompletar Código, selecione a caixa de seleção Janela Pop-up Autocompletar Código para chamar automaticamente esta janela quando estiver digitando determinados caracteres. O caractere default é "<tt>.</tt>", mas é possível adicionar seus próprios caracteres. </p> | |
| <p>Para adicionar caracteres que chamam a janela autocompletar código, selecione Java na lista drop-down Linguagem, e digite seus caracteres no campo Pop-up Automático de Triggers para Java. A janela autocompletar código aparecerá cada vez que você digitar os caracteres especificados.</p> | |
| <p>Quando a caixa de seleção Janela Pop-up Autocompletar Código estiver desativada, será necessário pressionar <tt>Ctlr-Espaço</tt> cada vez que precisar usar a opção autocompletar código. </p> | |
| </td> | |
| </tr> | |
| </table> | |
| <h3><a name="smart"></a>Sugestões Inteligentes no Topo </h3> | |
| <table class="full-width colapse"> | |
| <tr> | |
| <td width="45%"> | |
| <img alt="Caixa autocompletar código com sugestões inteligentes" src="../../../images_www/articles/73/java/editor-codereference/smartcompletion1.png"> </td> | |
| <td width="55%" class="valign-top"><p>No NetBeans IDE, a opção autocompletar código Java é "inteligente", o que significa que as sugestões que sejam as mais relevantes para o contexto de seu código são exibidas no topo, acima da linha preta na janela autocompletar código. </p> | |
| <p>No exemplo à esquerda, o editor sugere a inserção do construtor <tt>LinkedHashMap</tt> do pacote <tt>java.util</tt>. </p> | |
| <p>Se as sugestões "inteligentes" não são as que você deseja usar, pressione <tt>Ctlr-Espaço</tt> novamente para visualizar a lista completa. </p></td> | |
| </tr> | |
| </table> | |
| <h3><a name="keywords">Completando Palavras-chave</a></h3> | |
| <table class="full-width colapse"> | |
| <tr> | |
| <td width="45%"> | |
| <img alt="Conclusão de palavras-chave" class="img-left" src="../../../images_www/articles/73/java/editor-codereference/keywords.png"> </td> | |
| <td width="55%" class="valign-top"><p>Use autocompletar código (<tt>Ctlr-Espaço)</tt> para completar as palavras-chave em seu código. O editor analisa o contexto e sugere as palavras-chave mais relevantes. </p> | |
| <p>No exemplo na esquerda, a classe <tt>ColorChooserDemo</tt> estende a classe <tt>JPanel</tt>. Você pode adicionar rapidamente a palavra-chave <tt>extends</tt> a partir dos itens sugeridos.</p> | |
| </td> | |
| </tr> | |
| </table> | |
| <h3><a name="names"></a>Sugerindo nomes para Variáveis e Campos </h3> | |
| <table width="1216" class="full-width colapse"> | |
| <tr> | |
| <td width="45%"> | |
| <img alt="Conclusão de nomes e campos" src="../../../images_www/articles/73/java/editor-codereference/names.png"> </td> | |
| <td width="55%" class="valign-top"><p>Quando você está adicionando um novo campo ou uma variável, use autocompletar código (<tt>Ctlr-Espaço)</tt> para escolher um nome que coincida com seu tipo. </p> | |
| <p>Digite um prefixo para o novo nome, pressione <tt>Ctlr-Espaço</tt> e selecione o nome que deseja usar a partir da lista de sugestões. </p></td> | |
| </tr> | |
| </table> | |
| <h3><a name="parameters"></a>Sugerindo Parâmetros</h3> | |
| <table class="full-width colapse"> | |
| <tr> | |
| <td width="45%"> | |
| <img alt="Sugestões para formatos de parâmetro" src="../../../images_www/articles/73/java/editor-codereference/parameter.png"> </td> | |
| <td width="55%" class="valign-top"><p>O editor adivinha nos parâmetros para variáveis, métodos ou campos, e exibe as sugestões em uma caixa suspensa. </p> | |
| <p>Por exemplo, quando você seleciona um método na janela autocompletar código que tem um ou mais argumentos, o Editor realça o primeiro argumento e exibe uma dica de ferramentas sugerindo o formato para este argumento. Para mover para o próximo argumento, pressione as teclas <tt>Tab</tt> ou <tt>Enter</tt>. </p> | |
| <p>Você pode chamar as dicas de ferramenta com parâmetros de método ao pressionar <tt>Ctlr-P</tt> (ou Fonte > Mostrar Parâmetros de Método) a qualquer momento. </p> | |
| </td> | |
| </tr> | |
| </table> | |
| <h3><a name="prefix"></a> Conclusão de Prefixo Comum</h3> | |
| <table class="full-width colapse"> | |
| <tr> | |
| <td width="44%"> | |
| <img alt="Conclusão de prefixos" src="../../../images_www/articles/73/java/editor-codereference/prefixcompletion.png"> </td> | |
| <td width="56%" class="valign-top"><p>Você pode usar a tecla <tt>Tab</tt> para rapidamente preencher os prefixos mais usados e sugestões únicas. </p> | |
| <p>Para verificar como funciona esta funcionalidade, tente digitar o seguinte:</p> | |
| <ol> | |
| <li>Digite <tt>system.out.p</tt> e aguarde o recurso autocompletar código mostrar todos os campos e métodos que começam com "p". Todas as sugestões serão relacionadas à "impressão" </li> | |
| <li>Pressione a tecla <tt>Tab</tt> e o editor automaticamente preenche "print". <br> | |
| Você pode continuar e digita "l" e, após pressionar Tab, o "println" será adicionado. </li> | |
| </ol> | |
| </td> | |
| </tr> | |
| </table> | |
| <p>Na janela autocompletar código, são usados ícones para distinguir diferente membros da linguagem Java. Consulte o <a href="#appendixa">Apêndice A</a> no fim deste documento para ver o significados destes ícones. </p> | |
| <a href="#top">início</a> | |
| <h2><a name="imports"></a>Gerenciando Importações</h2> | |
| <p>Há diversas maneiras de trabalhar com instruções importadas. O Editor Java do IDE verifica constantemente seu código para o correto uso de instruções importadas e imediatamente avisa quando classes não-importadas ou instruções importadas não utilizadas são detectadas. </p> | |
| <table class="full-width colapse"> | |
| <tr> | |
| <td width="45%"> | |
| <p><img alt="Sugestões para uma instrução de importação" src="../../../images_www/articles/73/java/editor-codereference/imports3.png"> </p> | |
| <p> </p></td> | |
| <td width="55%" class="valign-top"><p>Quando uma classe não importada é encontrada, a marca de erro <img alt="Ícone de erro luminoso" src="../../../images_www/articles/73/java/editor-codereference/bulberror1.png"> aparece na margem esquerda do IDE (esta também é chamada de </em>margem glifo<em>). Clique na marca de erro e escolha se a importação faltante deve ser adicionada ou se a classe deve ser criada no pacote atual. </p> | |
| <p>Enquanto estiver digitando, pressione <tt>Ctrl-Shift-I</tt> (ou escolha Fonte > Corrigir importações, no menu) para adicionar todas as instruções faltantes de uma só vez.</p> | |
| <p>Pressione <tt>Alt-Shift-I</tt> para adicionar uma importação somente para o tipo no qual o cursor está localizado. </p> | |
| <p> </p> </td> | |
| </tr> | |
| <tr> | |
| <td width="45%"> | |
| <img alt="Adição automática de instruções de importação" src="../../../images_www/articles/73/java/editor-codereference/imports2.png"> </td> | |
| <td width="55%" class="valign-top"><p>Quando você seleciona uma classe na janela autocompletar código, o Editor adiciona automaticamente uma instrução importada por ele, portanto, não é preciso se preocupar com isso. </p> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td width="45%"><img alt="Remoção automática de importações não utilizadas" src="../../../images_www/articles/73/java/editor-codereference/imports.png"></td> | |
| <td width="55%" class="valign-top"><p>Se houver instruções de importação não utilizadas em seu código, pressione a <img alt="Ícone de advertência luminoso" src="../../../images_www/articles/73/java/editor-codereference/bulberror.png"> marca de advertência na margem esquerda do Editor e escolha para remover uma ou todas as importações não utilizadas. No Editor, as importações não utilizadas são sublinhadas (consulte a seção <a href="#coloring">Coloração Semântica</a> para obter detalhes).</p> | |
| <p>Para rapidamente ver se seu código contém importações não utilizadas ou faltantes, observe as linhas de erro na margem direita: linhas laranja marcam as importações faltantes ou não utilizadas. </p></td> | |
| </tr> | |
| </table> | |
| <p class="align-center"><a href="#top">início</a></p> | |
| <h2><a name="generatecode"></a>Gerando Código</h2> | |
| <p>Ao trabalhar no Editor Java, você pode gerar partes de código de duas maneiras: usando o recurso autocompletar código ou a partir da caixa de diálogo Geração de Código. Vamos examinar mais de perto exemplos simples de geração automática de código. </p> | |
| <h3>Usando a Caixa de Diálogo Geração de Código </h3> | |
| <table class="full-width colapse"> | |
| <tr> | |
| <td width="44%"><p><img alt="Geração do código da caixa de diálogo Geração do Código" src="../../../images_www/articles/73/java/editor-codereference/codegeneration1.png"></p> | |
| <p> </p></td> | |
| <td width="56%" class="valign-top"><p>Pressione <tt>Alt-Insert</tt> (ou escolha Código-fonte> Inserir Código) em qualquer parte do Editor para inserir um construtor com base na caixa Geração de Código. A lista sugerida é ajustada para o contexto atual.</p> | |
| <p>No exemplo na esquerda, vamos gerar um construtor para a classe Sample. Pressione <tt>Alt-Insert</tt>, selecione Construtor na caixa Geração de Código, e especifique os campos que serão inicializados pelo construtor. O Editor irá gerar o construtor com os parâmetros especificados.</p> | |
| <p>No Editor Java do IDE, é possível gerar automaticamente diversos construtores e métodos inteiros, substituir e delegar métodos, adicionar propriedades, e mais. </p> | |
| </td> | |
| </tr> | |
| </table> | |
| <h3>Usando Autocompletar Código </h3> | |
| <table class="full-width colapse"> | |
| <tr> | |
| <td width="44%"><img alt="Geração de código na janela Autocompletar Código" src="../../../images_www/articles/73/java/editor-codereference/codegeneration2.png"> </td> | |
| <td width="56%" class="valign-top"><p>Você também pode gerar código a partir da janela autocompletar código. Neste exemplo, usamos a mesma parte do código como acima, para mostrar como você pode gerar código a partir da janela autocompletar código.</p> | |
| <p>Pressione Ctrl-Espaço para abrir a janela autocompletar código e escolha o seguinte item: <tt>Sample(String name, int number) - gerar</tt>. O Editor irá gerar um construtor com os parâmetros especificados.</p> | |
| <p>Na janela autocompletar código, os construtores que podem ser gerados automaticamente são marcados com o <img alt="Ícone Gerar" src="../../../images_www/articles/73/java/editor-codereference/newconstructor.png"> ícone e a observação "<tt>gerar</tt>". Para obter mais explicações sobre os ícones e seus significados, consulte o <a href="#appendixa">Apêndice A</a>.</p></td> | |
| </tr> | |
| </table> | |
| <p class="align-center"><a href="#top">início</a></p> | |
| <h2><a id="codetemplates" name="codetemplates"></a>Modelos de Código</h2> | |
| <p>Um Modelo de Código é uma parte predefinida de código que tem uma abreviação associada a si. Consulte os exemplos abaixo que mostram como usar modelos de código.</p> | |
| <h3>Usando Modelos de Código</h3> | |
| <table class="full-width colapse"> | |
| <tr> | |
| <td width="44%"><p><img alt="Inserção de um modelo da janela Autocompletar Código" src="../../../images_www/articles/73/java/editor-codereference/livetemplate.png"></p> | |
| </td> | |
| <td width="56%" class="valign-top"><p>Modelos do código são marcados com o <img alt="Ícone modelo ao vivo" height="16" src="../../../images_www/articles/73/java/editor-codereference/codetemplateicon.png" width="16"> ícone na janela Autocompletar Código. </p> | |
| <p>Você pode adotar um dos seguintes procedimentos:</p> | |
| <ul> | |
| <li>Selecione um modelo a partir da janela autocompletar código e pressione Enter ou </li> | |
| <li>Digite a abreviatura para este modelo e pressione a tecla que expande este modelo (por default, <tt>Tab</tt>). </li> | |
| </ul> | |
| <p>No modelo expandido, as partes editáveis são exibidas como caixas azuis. Use a tecla <tt>Tab</tt> para passar pelas partes que você precisa editar. </p> </td> | |
| </tr> | |
| </table> | |
| <h3>Adicionando ou Editando Modelos de Código </h3> | |
| <table class="full-width colapse"> | |
| <tr> | |
| <td width="44%"> | |
| <p class="align-center"> | |
| <a href="../../../images_www/articles/73/java/editor-codereference/templateoptions.png" rel="lytebox" title="Personalizando modelos ao vivo"> <img alt="Personalizando modelos ao vivo" border="1" src="../../../images_www/articles/73/java/editor-codereference/templateoptions-small.png"></a></p> | |
| </td> | |
| <td width="56%" class="valign-top"><p>Para Personalizar os Modelos de Código:</p> | |
| <ol> | |
| <li>Escolha Ferramentas > Opções > Editor > Modelos de código. </li> | |
| <li>Na lista drop-down Linguagem, selecione Java (ou a linguagem para a qual deseja criar um modelo de código). A lista de abreviaturas e modelos associados é exibida. </li> | |
| <li>Use os botões Novo e Remover para adicionar ou remover modelo na lista. Para editar um modelo existente, selecione o modelo e edite o código no campo Texto expandido, abaixo na lista.</li> | |
| <li>Escolha a tecla que será usada para expandir os modelos. A tecla default é <tt>Tab</tt>. </li> | |
| </ol> | |
| <p>Consulte <a href="http://wiki.netbeans.org/Java_EditorUsersGuide#How_to_use_Code_Templates" target="_blank">este documento</a> para saber mais sobre a sintaxe para escrever novos Modelos de Código. </p> | |
| <p>Consulte também <a href="../../../kb/docs/php/code-templates.html">Modelos de Código no NetBeans IDE para PHP</a>.</p></td> | |
| </tr> | |
| </table> | |
| <p><a href="#top">início</a> </p> | |
| <h2><a name="javadoc"></a>Trabalhando com o Javadoc</h2> | |
| <p>Use as seguintes funcionalidades que facilitam trabalhar com o Javadoc para seu código. </p> | |
| <h3><a name="display"></a>Exibindo o Javadoc </h3> | |
| <table class="full-width colapse"> | |
| <tr> | |
| <td width="45%"><img alt="Janela Javadoc." src="../../../images_www/articles/73/java/editor-codereference/javadoc.png"> </td> | |
| <td width="55%" class="valign-top"><p>Coloque o cursor em um elemento e pressione <tt>Ctr-Shift-Espaço (ou escolha Código-fonte > Mostrar Documentação)</tt>. O Javadoc para este elemento é exibido em uma janela pop-up. </p> | |
| <p>No menu principal do IDE, clique em Janela > Outra > Javadoc, para abrir a janela Javadoc, na qual a documentação é automaticamente atualizada para a localização de seu cursor. </p> | |
| <p> </p> | |
| <p> </p> | |
| <p class="style1"> </p></td> | |
| </tr> | |
| </table> | |
| <h3><a name="create"></a>Criando Stubs de Javadoc </h3> | |
| <table class="full-width colapse"> | |
| <tr> | |
| <td width="45%"><img alt="Criação de stubs de Javadoc" src="../../../images_www/articles/73/java/editor-codereference/javadoc1.png"></td> | |
| <td width="55%" class="valign-top"><p>Coloque o cursor sobre um método ou classe que não tenha Javadoc, digite <tt>"/**</tt>", e pressione <tt>Enter</tt>. </p> | |
| <p>O IDE cria uma estrutura de esqueleto para o comentário Javadoc preenchido com algum conteúdo. Caso tenha a janela do Javadoc aberta, você verá imediatamente as alterações enquanto estiver digitando. </p> | |
| <p class="style1"> </p></td> | |
| </tr> | |
| </table> | |
| <h3><a name="hints"></a>Usando Dicas do Javadoc</h3> | |
| <table class="full-width colapse"> | |
| <tr> | |
| <td width="45%"><img alt="Uso de Dicas de Javadoc" src="../../../images_www/articles/73/java/editor-codereference/javadoc2.png"></td> | |
| <td width="55%" class="valign-top"><p>O IDE exibe dicas quando o Javadoc está faltando ou os identificadores Javadoc são necessários. </p> | |
| <p>Clique no ícone de bulbo na margem esquerda do editor para corrigir os erros do Javadoc. </p> | |
| <p>Caso não queira ver as dicas relacionadas com o Javadoc, escolha Ferramentas >Opções >Editor > Dicas, e desmarque a caixa de seleção Javadoc na lista de dicas que é exibida. </p> | |
| </td> | |
| </tr> | |
| </table> | |
| <h3><a name="usecc"></a>Usando AutoCompletar Código para Tags Javadoc </h3> | |
| <table width="100%" class="full-width colapse"> | |
| <tr> | |
| <td width="45%"><img alt="Autocompletar Código para Javadoc" src="../../../images_www/articles/73/java/editor-codereference/javadoc3.png"></td> | |
| <td width="55%" class="valign-top"><p>Autocompletar código está disponível para tags Javadoc. </p> | |
| <p>Digite o símbolo "@" e espere até que a janela autocompletar código seja aberta (dependendo de suas definições, pode ser preciso pressionar <tt>Ctlr-Espaço</tt>). </p> | |
| </td> | |
| </tr> | |
| </table> | |
| <h3><a id="generate-javadoc" name="generate-javadoc"></a>Gerando o Javadoc </h3> | |
| <table width="100%" class="full-width colapse"> | |
| <tr> | |
| <td width="45%"><img alt="Saída Javadoc gerada" src="../../../images_www/articles/73/java/editor-codereference/generate.png"></td> | |
| <td width="55%" class="valign-top"><p>Para gerar o Javadoc para um projeto, escolha o item de menu Executar > Gerar Javadoc (ou clique com o botão direito do mouse na janela Projetos e escolha Gerar Javadoc). O IDE irá gerar o Javadoc e irá abri-lo em uma janela separada do browser.</p> | |
| <p>No exemplo à esquerda, é possível visualizar um exemplo de saída do comando Gerar Javadoc. Se houver algumas advertências ou erros, eles também serão exibidos nesta janela.</p> | |
| <p>Para personalizar as opções de formatação do Javadoc, clique com o botão direito do mouse no projeto, escolha Propriedades, e abra o painel Documentação sob a categoria Construir (somente disponível em projetos Java). Para obter informações sobre as opções neste painel, clique no botão Ajuda nesta janela. </p></td> | |
| </tr> | |
| </table> | |
| <h3><a id="analyze-javadoc" name="analyze-javadoc"></a>Analisando o Javadoc </h3> | |
| <table width="100%" class="full-width colapse"> | |
| <tr> | |
| <td width="46%"><img alt="Janela Analisador do Javadoc" src="../../../images_www/articles/73/java/editor-codereference/analyze-javadoc.png"></td> | |
| <td width="54%" class="valign-top"><p>Para identificar os lugares em seu código que precisam de comentários Javadoc e inserir com rapidez estes comentários, é possível usar a ferramenta Analisador de Javadoc disponível no Editor Java.</p> | |
| <p>Para analisar e corrigir os comentários Javadoc:</p> | |
| <ol> | |
| <li>Selecione um projeto, um pacote, ou um arquivo individual, e escolha Ferramentas > Analisar Javadoc a partir do menu principal. <br> A janela Analisador exibe sugestões para adicionar ou corrigir comentários Javadoc, dependendo do escopo de sua seleção. </li> | |
| <li>Selecione uma ou diversas caixas de seleção onde gostaria de corrigir o Javadoc, e clique no botão Corrigir Selecionados. <br> | |
| </li> | |
| <li>Clique em Ir para Problemas Corrigidos e use as setas Acima e Abaixo para adicionar de fato seus comentários. Isso pode ser útil se você optou por corrigir diversas instâncias de uma só vez e agora deseja revisar os stubs. </li> | |
| </ol> </td> | |
| </tr> | |
| </table> | |
| <p class="align-center"><a href="#top">início</a></p> | |
| <h2 class="align-center"><a id="hints" name="hints"></a>Usando Dicas</h2> | |
| <p>Enquanto você está digitando, o Editor Java verifica seu código e fornece sugestões de como é possível corrigir os erros e navegar pelo código. Os exemplos abaixo mostram os tipos de dicas que estão disponíveis no Editor e como personalizá-las.</p> | |
| <h3><a id="hints-tofix" name="hints-tofix"></a>Usando Dicas para Corrigir o Código</h3> | |
| <table width="98%" class="full-width colapse"> | |
| <tr> | |
| <td width="44%"><img alt="Usando dicas para corrigir o código" src="../../../images_www/articles/73/java/editor-codereference/quickfixes.png"></td> | |
| <td width="56%" class="valign-top"><p>Para os erros mais comuns de código, você pode ver as dicas na margem esquerda do Editor. As dicas são mostradas para muitos tipos de erros, como um campo e definições de variável faltando, problemas com importações, chaves, e outros. Clique no ícone de dica e selecione a correção a ser adicionada. </p> | |
| <p>As dicas são automaticamente exibidas por default. No entanto, caso deseje exibir todas as dicas, escolha Fonte > Corrigir Código (ou pressione Alt-Enter).</p> | |
| <p>Por exemplo, tente digitar "myBoolean=true". O Editor detecta que esta variável não está definida. Clique no ícone de dica e veja que o Editor sugere que você crie um campo, um parâmetro de método ou uma variável local. Selecionar </p> | |
| </td> | |
| </tr> | |
| </table> | |
| <h3><a id="hints-customize" name="hints-customize"></a>Personalizando Dicas </h3> | |
| <table width="98%" class="full-width colapse"> | |
| <tr> | |
| <td width="44%"> | |
| <p class="align-center"> | |
| <a href="../../../images_www/articles/73/java/editor-codereference/customizehints.png" rel="lytebox" title="Opções de personalização para obter dicas"> <img alt="Opções de personalização para obter dicas" border="1" src="../../../images_www/articles/73/java/editor-codereference/customizehints-small.png"></a></p></td> | |
| <td width="56%" class="valign-top"><p>Você pode desejar limitar o número de categorias para as quais as dicas são exibidas. Para fazer isso: </p> | |
| <ol> | |
| <li>Escolha Ferramentas > Opções > Editor > Dicas. </li> | |
| <li>Na lista drop-down Linguagem, selecione Java e exiba uma lista de elementos para os quais dicas são exibidas (suas caixas de seleção estão selecionadas). </li> | |
| <li>Para desativar dicas para algumas categorias, desmarque as caixas de seleção apropriadas. </li> | |
| </ol> | |
| <p class="notes">Observação: na guia Dicas, também é possível desativar ou limitar o escopo das varreduras de dependência (opção Varredura de Dependência). Estas etapas podem aprimorar significativamente o desempenho do IDE. </p> | |
| <p>O IDE detecta os erros de compilação em seu código-fonte Java ao localizar e recompilar classes que dependem do arquivo que você está editando (mesmo que estas dependências estejam nos arquivos que não são abertos no editor). Quando um erro de compilação é encontrado, emblemas vermelhos são adicionados no arquivo de código-fonte, pacote ou nós do projeto. A varredura de dependência dentro de projetos pode consumir recursos e degradar o desempenho, especialmente se você estiver trabalhando em projetos grandes. </p> | |
| <p>Para aprimorar o desempenho do IDE, você pode adotar um dos seguintes procedimentos:</p> | |
| <ul> | |
| <li>Limite o escopo das varreduras de dependência para a Raiz do Código-fonte (pesquise por dependências somente na raiz do código-fonte onde a classe modificada está localizada) ou para o projeto atual. </li> | |
| <li>Desative a varredura de dependência (escolha Propriedades do Projeto > Construir > Compilando, e cancele a seleção da opção Rastrear Dependências Java). Neste caso, O IDE não efetua a varredura por dependências ou atualiza os símbolos de erro quando você modifica um arquivo. </li> | |
| </ul> | |
| </td> | |
| </tr> | |
| </table> | |
| <h3><a id="surround" name="surround"></a>Circundar com... </h3> | |
| <table width="98%" class="full-width colapse"> | |
| <tr> | |
| <td width="44%"><img alt="Circundam com opções" src="../../../images_www/articles/73/java/editor-codereference/surroundwith.png"></td> | |
| <td width="56%" class="valign-top"><p>É fácil circundar partes de seu código com diversas instruções, tais como<tt>for</tt>, <tt>while</tt>, <tt>if</tt>, <tt>try/catch</tt>, e outras.</p> | |
| <p>Selecione um bloco em seu código que deseja circundar com uma instrução e clique no ícone de bulbo na margem esquerda (ou pressione Alt-Enter). O Editor exibe uma lista de sugestões entre as quais é possível selecionar a instrução necessária.</p></td> | |
| </tr> | |
| </table> | |
| <h2 class="align-center"><a id="editor-features" name="editor-features"></a>Funcionalidades do Editor Geral </h2> | |
| <h3><a id="formatting" name="formatting"></a>Formatação do Código </h3> | |
| <table width="98%" class="full-width colapse"> | |
| <tr> | |
| <td width="46%"> | |
| <p class="align-center"> | |
| <a href="../../../images_www/articles/73/java/editor-codereference/formatting.png" rel="lytebox" title="Opções de personalização de formatação"> <img alt="Opções de personalização de formatação" border="1" src="../../../images_www/articles/73/java/editor-codereference/formatting-small.png"></a></p> | |
| </td> | |
| <td width="54%" class="valign-top"><p>Escolha Código-fonte > Formato, ou pressione <tt>Alt-Shift-F</tt> para formatar todo o arquivo ou uma seleção de código. O IDE formata o código de acordo com as definições de formatação especificadas.</p> | |
| <p>Para personalizar as definições de formatação para o código Java:</p> | |
| <ol> | |
| <li>Escolha Ferramentas > Opções > Editor > Formatação.</li> | |
| <li>Na lista drop-down Linguagem, selecione Java. </li> | |
| <li>Na lista drop-down Categoria, selecione a categoria que deseja personalizar. Por exemplo, você pode personalizar o número de linhas em branco, o tamanho das tabulações e recuos, estilo de mudança de linha etc.</li> | |
| <li>Modifique as regras para a categoria selecionada e exiba o resultado. </li> | |
| </ol></td> | |
| </tr> | |
| </table> | |
| <h3><a id="braces" name="braces"></a>Inserindo e Destacando Chaves, Colchetes e Aspas </h3> | |
| <table width="98%" class="full-width colapse"> | |
| <tr> | |
| <td width="46%"><p><img alt="Opções de personalização para parênteses" src="../../../images_www/articles/73/java/editor-codereference/braces.png"></p> | |
| </td> | |
| <td width="54%" class="valign-top"><p>Por default, o IDE insere automaticamente pares de chaves, colchetes e aspas. Quando você digita uma chave de abertura e a seguir pressiona <tt>Enter</tt>, a chave de fechamento é automaticamente adicionada. Para <tt>(</tt>, <tt>[</tt>, <tt>"</tt> e <tt>'</tt>, o Editor insere imediatamente um par coincidente.</p> | |
| <p>Se, por algum motivo, esta funcionalidade está desativada, ative o mesmo como segue: </p> | |
| <ol> | |
| <li>Escolha Ferramentas > Opções > Editor > Autocompletar Código.</li> | |
| <li>Marque a caixa de seleção Inserir Fechamento de Parênteses Automaticamente </li> | |
| </ol> | |
| <p>O Editor também realça os pares de chaves, colchetes e aspas coincidentes. Por exemplo, coloque o cursor antes de qualquer chave ou colchete e, e este tiver um par coincidente, ambos serão realçados em amarelo. Colchetes únicos de qualquer tipo são realçados em vermelho e a marca de erro é exibida na margem esquerda. </p> | |
| <p>Para personalizar as cores de realce, escolha Ferramentas > Opções > Fontes e Cores > Realce. </p></td> | |
| </tr> | |
| </table> | |
| <h3><a id="codefolding" name="codefolding"></a>Dobramento de Código</h3> | |
| <table width="98%" class="full-width colapse"> | |
| <tr> | |
| <td width="46%"><p><img alt="Exemplo de dobramento de código" src="../../../images_www/articles/73/java/editor-codereference/code-folded.png"></p></td> | |
| <td width="54%" class="valign-top"><p>No Editor Java, é possível contrair e expandir com rapidez blocos de código, como a declaração de método, comentários Javadoc, instruções de importação etc. Blocos contraíveis são mostrados com linhas cinzas e sinais de mais/menos junto a margem esquerda do Editor. </p> | |
| <ul> | |
| <li>A maneira mais fácil de contrair um bloco de código é a de clicar nas linhas cinzas com um caractere de sinal de menos na margem esquerda. </li> | |
| <li>Para dobrar todos os blocos contraíveis em um arquivo, clique com o botão direito do mouse no Editor e escolha Dobramentos de Código > Contrair Tudo no menu pop-up.</li> | |
| <li>No menu pop-up Dobramentos de Código > Contrair Tudo, é possível contrair todos os comentários Javadoc ou todos os códigos Javadoc em um arquivo.</li> | |
| <li>Você pode passar o mouse sobre os elementos dobrados para rever rapidamente as partes ocultas. </li> | |
| </ul> | |
| <p>Para personalizar as opções de dobramento de código:</p> | |
| <ol> | |
| <li>Escolha Ferramentas > Opções > Editor > Geral.</li> | |
| <li>Para desativar o dobramento de código, desmarque Usar Dobramento de Código. Observe que o dobramento de código é ativado por default.</li> | |
| <li>Selecione os blocos de código a serem contraídos por default quando você abre um arquivo.</li> | |
| </ol></td> | |
| </tr> | |
| </table> | |
| <h3><a id="customizeshortcuts" name="customizeshortcuts"></a>Personalizando Atalhos do Teclado</h3> | |
| <table width="98%" class="full-width colapse"> | |
| <tr> | |
| <td width="44%"> | |
| <p class="align-center"> | |
| <a href="../../../images_www/articles/73/java/editor-codereference/keyboard.png" rel="lytebox" title="Opções de personalização de formatação"> <img alt="Opções de personalização do teclado" border="1" src="../../../images_www/articles/73/java/editor-codereference/keyboard-small.png"></a></p></td> | |
| <td width="56%" class="valign-top"><p>No NetBeans IDE, escolha Ferramentas > Opções > Mapa de Teclas, para personalizar os atalhos de teclado. Você pode fazer isso de diversas maneiras:</p> | |
| <ul> | |
| <li>Selecione um conjunto predefinido de atalhos de teclado, denominado Perfil.</li> | |
| <li>Editar determinados atalhos de teclado. </li> | |
| </ul> | |
| <p>É possível salvar conjuntos personalizados de seus atalhos como perfis. A seguir, é possível alternar de um perfil para outro para alterar com rapidez múltiplas definições. Por exemplo, para criar um perfil personalizado de atalhos de teclado: </p> | |
| <ol> | |
| <li>Na janela Opções > Mapa de teclas, clique em Gerenciar perfis. </li> | |
| <li>Selecione o perfil que deseja usar como base para seu novo perfil e clique em Duplicar. </li> | |
| <li>Insira o nome do novo perfil e clique em OK. </li> | |
| <li>Assegure que o novo perfil está selecionado e modifique os atalhos que precisar.<br> Para editar um atalho, clique duas vezes no campo Atalho ou clique no botão de elipse (...). Quando você pressiona a sequência de teclas, a sintaxe para as mesmas é adicionada. <br> Se você deseja adicionar caracteres especiais , tais como <tt>Tab</tt>, <tt>Escape</tt> ou <tt>Enter</tt>, clique no botão de elipse (...) novamente e seleciona a tecla na janela pop-up.</li> | |
| <li>Quando tiver finalizado de editar, clique em OK na janela Opções. </li> | |
| </ol> | |
| <p>Para localizar um atalho para um comando específico, digite o nome do comando no campo Pesquisar. Para localizar um comando por uma combinação, insira o cursor no campo Pesquisar em atalhos e pressione a combinação de teclas de atalho. </p> | |
| <p> </p></td> | |
| </tr> | |
| </table> | |
| <h2><a name="coloring"></a>Coloração e Realces Semânticos </h2> | |
| <p>O Editor Java do IDE mostra elementos de código em cores distintas, com base na semântica de seu código. Com a coloração da semântica, torna-se mais fácil identificar diversos elementos em seu código. Além da coloração, o Editor Java realça elementos similares com uma determinada cor de plano de fundo. Portanto, você pode considerar a funcionalidade de realce como uma alternativa ao comando Pesquisar, porque em combinação com linhas de erro, fornece uma rápida visão geral de onde os locais realçados estão localizados no arquivo. </p> | |
| <h3><a name="customizecolors"></a>Personalizando Cores </h3> | |
| <table width="98%" class="full-width colapse"> | |
| <tr> | |
| <td width="44%"> | |
| <p class="align-center"> | |
| <a href="../../../images_www/articles/73/java/editor-codereference/coloringoptions.png" rel="lytebox" title="Opções de personalização de cores"> <img alt="Opções de personalização de cores" border="1" src="../../../images_www/articles/73/java/editor-codereference/coloringoptions-small.png"></a></p></td> | |
| <td width="56%" class="valign-top"><p>Para personalizar as definições de coloração de semântica para o Editor Java, escolha Ferramentas > Opções > Fontes e Cores.</p> | |
| <p>O IDE fornece esquemas predefinidos de esquemas de coloração, denominados perfis. Você pode criar novos perfis com cores personalizadas e rapidamente alternar entre as mesmas. </p> | |
| <p>É muito conveniente salvar cores personalizadas em novos perfis. Por exemplo, execute os seguintes procedimentos: </p> | |
| <ol> | |
| <li>Na janela Opções > Fontes e Cores, clique em Duplicar junto a listas drop-down Perfil. </li> | |
| <li>Insira o nome do novo perfil e clique em OK. </li> | |
| <li>Assegure que o novo perfil está no momento selecionado e escolha Java na lista drop-down Linguagem. </li> | |
| <li>Selecione a categoria para alterar a fonte, cor da fonte (primeiro plano), cor do plano de fundo, e os efeitos para esta categoria. <br> Use a janela Visualizar para exibir os resultados.</li> | |
| <li>Clique em OK. </li> | |
| </ol> | |
| <p class="notes">Observação: todas as definições do NetBeans IDE e dos perfis são armazenadas no <em>NetBeans userdir</em> (consulte a <a href="http://wiki.netbeans.org/FaqWhatIsUserdir" target="_blank">FAQ</a> sobre como localizar o <em>userdir</em> para seu sistema operacional). Ao atualizar para versões mais recentes do NetBeans, você pode exportar as definições antigas e importá-las na versão mais recente.</p> | |
| <p class="notes">Para exportar as definições IDE: </p> | |
| <ol> | |
| <li>Na janela Opções (Ferramentas > Opções) clique em Exportar.</li> | |
| <li>Especifique a localização e nome do arquivo ZIP que será criado. </li> | |
| <li>Selecione as definições que deseja exportar e clique em OK. </li> | |
| </ol> | |
| <p class="notes">Para importar definições IDE: </p> | |
| <ol> | |
| <li>Na janela Opções (Ferramentas > Opções) clique em Importar.</li> | |
| <li>Especifique o arquivo ZIP com as definições IDE ou o caminho para o <em>userdir</em> de uma versão anterior. </li> | |
| <li>Selecione as definições que deseja importar e clique em OK. </li> | |
| </ol> <p> </p></td> | |
| </tr> | |
| </table> | |
| <h3><a id="example" name="example"></a>Exemplo de Coloração</h3> | |
| <table width="98%" class="full-width colapse"> | |
| <tr> | |
| <td width="44%"><p><img alt="Imagem mostrando uma coloração exemplo" src="../../../images_www/articles/73/java/editor-codereference/coloring.png"></p></td> | |
| <td width="56%" class="valign-top"><p>À esquerda, você pode ver um exemplo de um esquema de coloração. Dependendo de suas definições personalizadas, suas cores podem parecer diferentes das mostradas na captura de tela. </p> | |
| <p>São usadas cores distintas para palavras-chave (azul), variáveis e campos (verde) e parâmetros (laranja). </p> | |
| <p>Referências aos métodos ou classes obsoletos são mostrados com tachados. Isso o alerta quando estiver escrevendo um código que se baseie em membros obsoletos. </p> | |
| <p>Membros não utilizados são sublinhados com uma linha ondulada cinza. Os comentários são exibidos em cinza.</p> | |
| <p> </p></td> | |
| </tr> | |
| </table> | |
| <h3><a id="highlights" name="highlights"></a>Usando Realces</h3> | |
| <table width="98%" class="full-width colapse"> | |
| <tr> | |
| <td width="44%"><p><img alt="Imagem mostrando o uso de destaca" src="../../../images_www/articles/73/java/editor-codereference/highlightelement.png"></p></td> | |
| <td width="56%" class="valign-top"><p>O IDE realça os usos do mesmo elemento, chaves coincidentes, pontos de saída do método, e pontos que causam exceção. </p> | |
| <p>Se você coloca o cursor sobre um elemento, como um campo ou variável, todos os usos deste elemento são realçados. Observe que as linhas de erro na margem direita do Editor indicam os usos deste elemento em todo o arquivo de código-fonte (consulte <a href="#stripes">Linhas de Erro</a>). Clique na faixa de erro para navegar com rapidez para a localização de uso desejada.</p> | |
| <p>Caso você decida renomear todas as instâncias realçadas, use o comando Renomeação instantânea (Ctrl-R ou escolha Refatorar > Renomear). </p> | |
| <p> </p> | |
| </td> | |
| </tr> | |
| </table> | |
| <h2><a name="navigation"></a>Navegação</h2> | |
| <p>O Editor Java fornece diversas maneiras para poder navegar pelo código. Consulte abaixo para obter diversos exemplos que mostram as funcionalidades de navegação do Editor Java. </p> | |
| <h3><a name="stripes"></a>Faixas de Erro</h3> | |
| <p>As faixas de erro na margem direita do Editor fornecem uma visão geral rápida de todos os lugares marcados no arquivo atual: erros, advertências, dicas, ocorrências realçadas e anotações. Observe que a margem de faixa de erro representa todo um arquivo, não apenas a parte que está no momento exibida no Editor. Usando faixas de erro, você pode identificar imediatamente se há erros ou advertências no arquivo sem ser preciso percorrer o arquivo inteiro. </p> | |
| <p>Clique em uma faixa de erro para saltar para a faixa à qual a marca se refere. </p> | |
| <h3><a name="goto"></a>Navegando no Editor. Ir para... </h3> | |
| <table width="98%" class="full-width colapse"> | |
| <tr> | |
| <td width="44%"><p><img alt="Imagem mostrando o comando Ir para" src="../../../images_www/articles/73/java/editor-codereference/gotodeclaration.png"></p></td> | |
| <td width="56%" class="valign-top"><p>Use os seguintes comandos "Ir para.." localizados sob o item de menu Navegar para ir com rapidez para as localizações de destino.</p> | |
| <ul> | |
| <li><strong>Ir para a Declaração ( Ctrl-B, por default)</strong>. Mantenha pressionada a tecla Ctrl e clique no uso de uma classe, método ou campo, para saltar para sua declaração. Você também pode colocar o cursor sobre o membro (uma classe, método ou campo) e escolher Navegar > Ir para a declaração, ou clicar com o botão direito do mouse e escolher Navegar > Ir para a declaração, no menu pop-up. </li> | |
| <li><strong>Ir para o Código-fonte ( Cltr-Shift-B, por default)</strong>. Mantenha pressionada a tecla Ctrl e clique no em uma classe, método ou campo, para saltar para o código-fonte, se este estiver disponível. Você também pode colocar o cursor sobre o membro (uma classe, método ou campo) e pressionar Ctrl-Shift-B ou escolher Navegar > Ir para o Código-fonte, no menu principal.</li> | |
| </ul></td> | |
| </tr> | |
| </table> | |
| <table width="98%" class="full-width colapse"> | |
| <tr> | |
| <td width="44%"><p><img alt="Imagem que mostra a caixa de diálogo Tipo para Tipo" src="../../../images_www/articles/73/java/editor-codereference/gototype.png"></p></td> | |
| <td width="56%" class="valign-top"><ul> | |
| <li><strong>Ir para Tipo (Ctrl-O)</strong>, <strong>Ir para Arquivo (Alt-Shift-O)</strong> e <strong>Ir para Símbolo (Ctrl-Alt-Shift-O)</strong>. Se você conhece o nome do tipo (classe, interface, anotação ou enum), arquivo ou símbolo para onde deseja saltar, use estes comandos e digite o nome na nova janela. Observe que você pode usar prefixos, camel case e caracteres curinga. </li> | |
| </ul></td> | |
| </tr> | |
| </table> | |
| <table width="98%" class="full-width colapse"> | |
| <tr> | |
| <td width="44%"><p><img alt="Imagem que mostra a caixa de diálogo Ir para Linha" src="../../../images_www/articles/73/java/editor-codereference/gotoline.png"></p></td> | |
| <td width="56%" class="valign-top"><ul> | |
| <li><strong>Ir para Linha (Ctrl-G)</strong>. Insira o número da linha para a qual deseja saltar. </li> | |
| </ul></td> | |
| </tr> | |
| </table> | |
| <h3><a name="lastedit"></a>Saltando para Última Edição</h3> | |
| <table width="98%" class="full-width colapse"> | |
| <tr> | |
| <td width="44%"><p><img alt="Imagem que mostra o botão Saltando para Última Edição" src="../../../images_www/articles/73/java/editor-codereference/jumplastedit.png"></p></td> | |
| <td width="56%" class="valign-top"><p>Para retornar com rapidez para sua última edição, mesmo se estiver em outro arquivo ou projeto, pressione Ctrl-Q ou use o botão para no canto superior esquerdo na barra de ferramentas do Editor Java. O último documento editado é aberto, e o cursor está sob a posição editada por último.</p></td> | |
| </tr> | |
| </table> | |
| <h3><a id="switchfiles" name="switchfiles"></a>Alternando entre Arquivos </h3> | |
| <table width="98%" class="full-width colapse"> | |
| <tr> | |
| <td><p><img alt="Imagem mostrando os botões usados para alternar entre arquivos abertos" src="../../../images_www/articles/73/java/editor-codereference/jumprecentfile.png"></p> | |
| <p> </p></td> | |
| <td class="valign-top"><p>Há duas funcionalidades bem úteis que permitem alternar entre arquivos abertos: </p> | |
| <ul> | |
| <li><strong>Voltar (Alt-Esquerda)</strong> e <strong>Avançar para (Alt-Direita).</strong> Para ir para o arquivo editado anteriormente ou mover para frente, escolha Navegar < Voltar ou navegar < para frente ou pressione os botões correspondentes na barra de ferramentas do editor (mostrado na figura). O arquivo é aberto é o cursor é colocado na localização de sua última edição. Quando você clica em um destes botões, poderá expandir a lista de arquivos recentes e clicar para navegar para qualquer um deles. </li> | |
| </ul></td> | |
| </tr> | |
| <tr> | |
| <td width="44%"><p><img alt="Imagem mostrando um menu pop-up para alternar entre arquivos" src="../../../images_www/articles/73/java/editor-codereference/togglefile.png"></p></td> | |
| <td width="56%" class="valign-top"><ul> | |
| <li><strong>Alternar entre Arquivos (Ctrl-Tab)</strong>. Após pressionar Ctrl-Tab, todos os arquivos abertos são mostrados em uma janela pop-up. Mantenha pressionada a tecla Ctrl e pressione diversas vezes a tecla Tab para escolher o arquivo que deseja abrir.</li> | |
| </ul></td> | |
| </tr> | |
| </table> | |
| <h3><a name="bookmarks"></a>Usando Marcadores</h3> | |
| <table width="98%" class="full-width colapse"> | |
| <tr> | |
| <td width="44%"><p><img alt="Imagem que mostra um exemplo de um marcador" src="../../../images_www/articles/73/java/editor-codereference/bookmark.png"></p></td> | |
| <td width="56%" class="valign-top"><p>Você pode usar indicadores para navegar com rapidez entre determinados lugares em seu código. </p> | |
| <p>Pressione Ctrl-Shift-M (ou clique com o botão direito do mouse na margem esquerda e escolha Marcador > Alternar Marcador) para colocar um marcador na linha atual. A linha com marcador é mostrada com um ícone azul pequeno na margem esquerda (consulte a figura).</p> | |
| <p>Para remover o marcador, pressione Ctrl-Shift-M novamente.</p> | |
| <p>Para ir para o próximo marcador, pressione Ctrl-Shift-Ponto, para ir para o marcador anterior, pressione Ctrl-Shift-Vírgula. </p> | |
| </td> | |
| </tr> | |
| </table> | |
| <h3><a name="navigator"></a>Usando o Navegador </h3> | |
| <table width="98%" class="full-width colapse"> | |
| <tr> | |
| <td width="44%"><p><img alt="Exemplo da janela do Navegador" src="../../../images_www/articles/73/java/editor-codereference/navigatorwindow.png"></p></td> | |
| <td width="56%" class="valign-top"><p>A janela Navegador fornece views estruturadas do arquivo atualmente sendo trabalhado e permite navegar com rapidez entre diferentes partes do arquivo. </p> | |
| <p>Para abrir a janela Navegador, escolha Janela > Navegação > Navegador ou pressione Ctrl-7.</p> | |
| <p>Na janela Navegador, você pode fazer o seguinte:</p> | |
| <ul> | |
| <li>Escolher entre diferentes views: Membros, Padrões Bean, Árvores, Elementos, etc.</li> | |
| <li>Clicar duas vezes em um elemento para saltar para a linha onde ele está definido.</li> | |
| <li>Clicar com o botão direito do mouse e aplicar comandos, como Ir para o Código-fonte, Localizar Usos e Refatorar.</li> | |
| <li>Aplicar filtros aos elementos exibidos no Navegador (use os botões na parte inferior).</li> | |
| <li>Digitar o nome do elemento que deseja localizar (a janela Navegador precisa estar ativa).</li> | |
| </ul> | |
| <p> </p> | |
| </td> | |
| </tr> | |
| </table> | |
| <p><br> | |
| </p> | |
| <div class="feedback-box" ><a href="/about/contact_form.html?to=3&subject=Feedback:%20Code%20Assistance%20in%20the%20NetBeans%20IDE%20Java%20Editor">Enviar Feedback neste Tutorial</a><br style="clear:both;"> <a name="next_steps"></a></div> | |
| <h2>Consulte Também</h2> | |
| <ul> | |
| <li><a href="../../../kb/docs/java/java-editor-screencast.html">Screencast: Editando Código Java no NetBeans IDE</a> </li> | |
| <li><a href="http://netbeans.org/project_downloads/usersguide/shortcuts-72.pdf" target="_blank">Cartão de Atalhos do Teclado</a> </li> | |
| <li><a href="http://netbeans.org/project_downloads/www/shortcuts.pdf" target="_blank">Cartão de Atalhos do NetBeans IDE</a> (download)</li> | |
| </ul> | |
| <p class="align-center"><a href="#top">início</a></p> | |
| <a name="appendixa"></a><h2 class="align-center">Apêndice A: Ícones na Janela Autocompletar Código</h2> | |
| <table> | |
| <tbody> | |
| <tr> | |
| <td class="tblheader">Ícone</td> | |
| <td class="tblheader">Significado</td> | |
| <td class="tblheader">Variantes (se houver)</td> | |
| <td class="tblheader"><p>Significado </p> </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd0"><img alt="Ícone Tipo de anotação" src="../../../images_www/articles/73/java/editor-codereference/annotation_type.png"></td> | |
| <td class="tbltd0">Tipo de anotação</td> | |
| <td class="tbltd0"> </td> | |
| <td class="tbltd0"> </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"><img alt="Ícone de classe" src="../../../images_www/articles/73/java/editor-codereference/class_16.png"></td> | |
| <td class="tbltd1">Classe</td> | |
| <td class="tbltd1"> </td> | |
| <td class="tbltd1"> </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd0"><img alt="Ícone de pacote" height="16" src="../../../images_www/articles/73/java/editor-codereference/package.png" width="16"></td> | |
| <td class="tbltd0">Pacote</td> | |
| <td class="tbltd0"> </td> | |
| <td class="tbltd0"> </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"><img alt="Ícone do tipo de enumeração" height="16" src="../../../images_www/articles/73/java/editor-codereference/enum.png" width="16"></td> | |
| <td class="tbltd1">Tipo de enumeração </td> | |
| <td class="tbltd1"> </td> | |
| <td class="tbltd1"> </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd0"><img alt="Ícone do Modelo de Código" height="16" src="../../../images_www/articles/73/java/editor-codereference/code_template.png" width="16"></td> | |
| <td class="tbltd0">Modelo de Código </td> | |
| <td class="tbltd0"> </td> | |
| <td class="tbltd0"> </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"><img alt="Ícone do Construtor" height="16" src="../../../images_www/articles/73/java/editor-codereference/constructor_16.png" width="16"></td> | |
| <td class="tbltd1">Construtor</td> | |
| <td class="tbltd1"><img alt="Ícone novo construtor" height="16" src="../../../images_www/articles/73/java/editor-codereference/new_constructor_16.png" width="16"></td> | |
| <td class="tbltd1"> Novo construtor (gerar)</td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"> </td> | |
| <td class="tbltd1"> </td> | |
| <td class="tbltd1"><img alt="Ícone Construtor protegido" height="16" src="../../../images_www/articles/73/java/editor-codereference/constructor_protected_16.png" width="16"></td> | |
| <td class="tbltd1">Construtor protegido </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"> </td> | |
| <td class="tbltd1"> </td> | |
| <td class="tbltd1"><img alt="Ícone Construtor privado" height="16" src="../../../images_www/articles/73/java/editor-codereference/constructor_private_16.png" width="16"></td> | |
| <td class="tbltd1">Construtor privado </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"> </td> | |
| <td class="tbltd1"> </td> | |
| <td class="tbltd1"><img alt="Ícone construtor privado do pacote" height="16" src="../../../images_www/articles/73/java/editor-codereference/constructor_package_private_16.png" width="16"></td> | |
| <td class="tbltd1">Construtor privado do pacote </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd0"><img alt="Ícone do campo" height="16" src="../../../images_www/articles/73/java/editor-codereference/field_16.png" width="16"></td> | |
| <td class="tbltd0">Campo</td> | |
| <td class="tbltd0"><img alt="Ícone do campo protegido" height="16" src="../../../images_www/articles/73/java/editor-codereference/field_protected_16.png" width="16"></td> | |
| <td class="tbltd0">Campo protegido </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd0"> </td> | |
| <td class="tbltd0"> </td> | |
| <td class="tbltd0"><img alt="Ícone campo privado" height="16" src="../../../images_www/articles/73/java/editor-codereference/field_private_16.png" width="16"></td> | |
| <td class="tbltd0">Campo privado </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd0"> </td> | |
| <td class="tbltd0"> </td> | |
| <td class="tbltd0"><img alt="Campo Ícone para pacote privado" height="16" src="../../../images_www/articles/73/java/editor-codereference/field_package_private_16.png" width="16"></td> | |
| <td class="tbltd0">Campo pacote privado </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"><img alt="Ícone para campos estáticos" height="16" src="../../../images_www/articles/73/java/editor-codereference/field_static_16.png" width="16"></td> | |
| <td class="tbltd1">Campo estático </td> | |
| <td class="tbltd1"><img alt="Ícone para campos estáticos protegidos" height="16" src="../../../images_www/articles/73/java/editor-codereference/field_static_protected_16.png" width="16"></td> | |
| <td class="tbltd1">Campo estático protegido </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"> </td> | |
| <td class="tbltd1"> </td> | |
| <td class="tbltd1"><img alt="Ícone para campos estáticos privados" height="16" src="../../../images_www/articles/73/java/editor-codereference/field_static_private_16.png" width="16"></td> | |
| <td class="tbltd1">Campo estático privado </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"> </td> | |
| <td class="tbltd1"> </td> | |
| <td class="tbltd1"><img alt="Ícone para campos estáticos privados do pacote" height="16" src="../../../images_www/articles/73/java/editor-codereference/field_static_package_private_16.png" width="16"></td> | |
| <td class="tbltd1">Campo estático privado do pacote </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd0"><img alt="Ícone da interface" height="16" src="../../../images_www/articles/73/java/editor-codereference/interface.png" width="16"></td> | |
| <td class="tbltd0">Interface</td> | |
| <td class="tbltd0"> </td> | |
| <td class="tbltd0"> </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"><img alt="Ícone da palavra-chave Java" height="16" src="../../../images_www/articles/73/java/editor-codereference/javakw_16.png" width="16"></td> | |
| <td class="tbltd1">Palavra-chave Java </td> | |
| <td class="tbltd1"> </td> | |
| <td class="tbltd1"> </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd0"><img alt="Ícone do método" height="16" src="../../../images_www/articles/73/java/editor-codereference/method_16.png" width="16"></td> | |
| <td class="tbltd0">Método</td> | |
| <td class="tbltd0"><img alt="Ícone para métodos protegidos" height="16" src="../../../images_www/articles/73/java/editor-codereference/method_protected_16.png" width="16"></td> | |
| <td class="tbltd0">Método protegido </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd0"> </td> | |
| <td class="tbltd0"> </td> | |
| <td class="tbltd0"><img alt="Ícone para métodos privados" height="16" src="../../../images_www/articles/73/java/editor-codereference/method_private_16.png" width="16"></td> | |
| <td class="tbltd0">Método privado </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd0"> </td> | |
| <td class="tbltd0"> </td> | |
| <td class="tbltd0"><img alt="Ícone para métodos privados do pacote" height="16" src="../../../images_www/articles/73/java/editor-codereference/method_package_private_16.png" width="16"></td> | |
| <td class="tbltd0">Método privado do pacote </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"><img alt="Ícone para métodos estáticos" height="16" src="../../../images_www/articles/73/java/editor-codereference/method_static_16.png" width="16"></td> | |
| <td class="tbltd1">Método estático </td> | |
| <td class="tbltd1"><img alt="Ícone para métodos estáticos protegidos" height="16" src="../../../images_www/articles/73/java/editor-codereference/method_static_protected_16.png" width="16"></td> | |
| <td class="tbltd1">Método estático protegido </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"> </td> | |
| <td class="tbltd1"> </td> | |
| <td class="tbltd1"><img alt="Ícone para métodos estáticos privados" height="16" src="../../../images_www/articles/73/java/editor-codereference/method_static_private_16.png" width="16"></td> | |
| <td class="tbltd1">Método estático privado </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"> </td> | |
| <td class="tbltd1"> </td> | |
| <td class="tbltd1"><img alt="Ícone para métodos estáticos privados do pacote" height="16" src="../../../images_www/articles/73/java/editor-codereference/method_static_package_private_16.png" width="16"></td> | |
| <td class="tbltd1">Método estático privado do pacote </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd0"><img alt="Ícone da variável local" height="16" src="../../../images_www/articles/73/java/editor-codereference/localVariable.png" width="16"></td> | |
| <td class="tbltd0">Variável local </td> | |
| <td class="tbltd0"> </td> | |
| <td class="tbltd0"> </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"><img alt="Ícone do atributo" src="../../../images_www/articles/73/java/editor-codereference/attribute_16.png"></td> | |
| <td class="tbltd1">Atributo</td> | |
| <td class="tbltd1"> </td> | |
| <td class="tbltd1"> </td> | |
| </tr> | |
| </tbody> | |
| </table> | |
| <script type="text/javascript"> | |
| <!-- | |
| compactMenu('collapsableList', true, '± '); | |
| --> | |
| </script> | |
| </body> | |
| </html> |