Tratando Imagens em Java
Tratando Imagens em Java
Introdução Training
Criando o Form da Aplicação
Java Programming
Adicionando um Pacote na Imagem
Language
Exibindo a Imagem no Label
Construindo e Executando a Aplicação
Exibindo a Imagem como Plano de Fundo no Quadro Support
Criando Código Personalizado
Oracle Development Tools
Resumo Support Offering for
Consulte Também NetBeans IDE
Para concluir este tutorial, você precisa dos seguintes recursos e softwares.
Documentation
Software ou Recurso Versão Necessária General Java Development
NetBeans IDE Versão 7.4 ou 8.0 External Tools and Services
Java GUI Applications
JDK (Java Development Kit) Versão 6, 7 ou 8
Java EE & Java Web
Development
Introdução Web Services Applications
O tratamento de imagens em uma aplicação é um problema comum para muitos programadores iniciantes em Java. A forma NetBeans Platform (RCP)
padrão de acessar as imagens em uma aplicação Java é por meio do método getResource(). Este tutorial mostra como usar o and Module Development
GUI Builder do IDE para gerar o código a fim de que inclua imagens (e outros recursos) em sua aplicação. Além disso, você PHP and HTML5
aprenderá como personalizar a forma na qual o IDE gera o código de tratamento de imagens. Applications
C/C++ Applications
A aplicação resultante deste tutorial será um JFrame simples que contém um JLabel que exibe uma única imagem.
Mobile Applications
2. No assistente Novo Projeto, selecione Java > Aplicação Java e clique em Próximo.
More
3. Em Nome do Projeto, digite ImageDisplayApp.
FAQs
4. Desmarque a caixa de seleção Criar Classe Principal. Contribute Documentation!
Docs for Earlier Releases
5. Clique em Finalizar.
2. Clique com o botão direito do mouse no nó Pacotes de Código-fonte e escolha Novo > Form JFrame.
5. Clique em Finalizar.
https://netbeans.org/kb/docs/java/gui-image-display_pt_BR.html 1/9
11/10/2019 Tratando Imagens em uma Aplicação Java GUI - Tutorial do NetBeans IDE
Até este momento, o form deve ser semelhante à seguinte imagem:
1. Na janela Projetos, clique com o botão direito do mouse no nó org.me.myimageapp e escolha Novo > Pacote Java.
2. Clique em Finalizar.
Na janela Projetos, você deve ver um novo pacote que aparece na pasta Pacotes do Código-fonte.
https://netbeans.org/kb/docs/java/gui-image-display_pt_BR.html 2/9
11/10/2019 Tratando Imagens em uma Aplicação Java GUI - Tutorial do NetBeans IDE
5. Na seletor de arquivos, vá até qualquer imagem que esteja em seu sistema que você queira usar. Em seguida, clique em
Próximo.
6. Na página Selecionar pasta de destino do assistente, selecione a pasta newpackage e clique em Finalizar.
Copia a imagem para seu projeto. Portanto, quando você constrói e distribui a aplicação, a imagem é incluída no arquivo
JAR distribuível.
Neste momento, você pode realizar alguns procedimentos simples para melhorar a aparência do form, como:
Na janela Propriedades, selecione a propriedade text e delete jLabel1. Tal valor foi gerado pelo GUI Builder para exibir
o texto do label. No entanto, você está usando o label para exibir uma imagem em vez do texto, de modo que o texto não
seja necessário.
https://netbeans.org/kb/docs/java/gui-image-display_pt_BR.html 3/9
11/10/2019 Tratando Imagens em uma Aplicação Java GUI - Tutorial do NetBeans IDE
1. No Designer do GUI, clique no botão Código-fonte. (Selecione Exibir > Barra de Ferramentas Editor de Código-fonte do
menu principal se o botão Código-fonte estiver oculto.)
3. Clique no sinal de mais (+) à esquerda da linha Código Gerado para exibir o código que o Designer de GUI gerou.
A linha-chave é a seguinte:
jLabel1.setIcon(new
javax.swing.ImageIcon(getClass().getResource("/org/me/myimageapp/newpackage/image.png
"))); // NOI18N
Visto que você usou o editor de propriedades da propriedade do Ícone do jLabel1, o IDE gerou o método setIcon. O
parâmetro de tal método contém uma chamada ao método getResource() em uma classe anônima interna de ImageIcon.
Observe que o caminho gerado da imagem correspondente à sua localização na estrutura de pacote da aplicação.
Observações:
Se você usar a opção Imagem Externa no editor de propriedades do ícone, o IDE gerará um caminho absoluto para a
imagem em vez de copiar a imagem no seu projeto. Portanto, a imagem seria exibida ao executar a aplicação no sistema,
mas possivelmente não seria exibida ao executar a aplicação em outro sistema.
O método getResource também é útil para acessar outros tipos de recursos, como arquivos de texto que contêm dados
que a aplicação talvez precise usar.
Na View Design, clique com o botão direito do mouse em JLabel e escolha Eventos > Mouse >
mouseClicked/mousePressed/mouseReleased no menu pop-up.
Um handler de evento é gerado para o evento correspondente.
Observação: você pode obter coordenadas do mouse (por exemplo, a localização de um clique do mouse) no handler de
evento usando os métodos event.getPoint(), event.getX() ou event.getY(). Consulte Classe MouseEvent
para obter detalhes.
2. No assistente Novo Projeto, selecione Java > Aplicação Java e clique em Próximo.
https://netbeans.org/kb/docs/java/gui-image-display_pt_BR.html 4/9
11/10/2019 Tratando Imagens em uma Aplicação Java GUI - Tutorial do NetBeans IDE
5. Clique em Finalizar.
7. Clique com o botão direito do mouse no nó Pacotes de Código-fonte e escolha Novo > Form JFrame.
11. Na view Design, clique com o botão direito do mouse em JFrame e selecione Definir Layout > Layout do Conjunto de
Grades no menu pop-up.
12. Clique com o botão direito do mouse em JFrame e selecione Adicionar da Paleta > Contêineres Swing > Painel no menu
pop-up.
14. Clique com o botão direito do mouse em JFrame e selecione Adicionar da Paleta > Controles do Swing > Label no menu
pop-up.
15. Na janela Projetos, clique com o botão direito do mouse no nó org.me.mybackgroundapp e escolha Novo > Pacote
Java.
18. Na janela Propriedades, clique na categoria Propriedades e role até a propriedade do ícone.
21. Na seletor de arquivos, vá até qualquer imagem que esteja em seu sistema que você queira usar. Em seguida, clique em
Próximo.
22. Na página Selecionar Pasta de Destino do assistente, selecione a pasta de recursos newpackage e clique em Finalizar.
24. No navegador, clique com o botão direito do mouse em jPanel e escolha Propriedades no menu pop-up.
25. Na caixa de dialogo Propriedades, defina as propriedades Grid X, Grid Y, Weight X e Weight Y como 1 e a
propriedade Fill como Both.
https://netbeans.org/kb/docs/java/gui-image-display_pt_BR.html 5/9
11/10/2019 Tratando Imagens em uma Aplicação Java GUI - Tutorial do NetBeans IDE
O segundo plano está pronto. Agora você pode arrastar um jLabel e um jTextField ao jPanel a partir da Paleta, por
exemplo. Ambos serão exibidos sobre a imagem de segundo plano.
https://netbeans.org/kb/docs/java/gui-image-display_pt_BR.html 6/9
11/10/2019 Tratando Imagens em uma Aplicação Java GUI - Tutorial do NetBeans IDE
Observação: a vantagem da solução descrita é que a imagem de segundo plano é mostrada no período do projeto e no
runtime.
Você precisa, primeiro, definir a classe principal do projeto. Quando você define a classe principal, o IDE sabe quais classes
executar quando o projeto é executado. Além disso, isso garante que o elemento Main-Class no arquivo JAR do projeto seja
gerado quando você construir a aplicação.
3. Clique no botão Procurar ao lado do campo Classe Principal. Depois selecione a classe
org.me.myimageapp.ImageDisplay.
Escolha Executar > Limpar & Criar Projeto (project_name) na barra de ferramentas principal.
Você pode exibir os produtos construídos da aplicação na janela Arquivos. A pasta build contém a classe compilada. A pasta
dist contém um arquivo JAR executável que contém a classe compilada e a imagem.
https://netbeans.org/kb/docs/java/gui-image-display_pt_BR.html 7/9
11/10/2019 Tratando Imagens em uma Aplicação Java GUI - Tutorial do NetBeans IDE
Se precisar escolher a imagem a ser exibida programaticamente, você pode escrever seu próprio código personalizado para
acessar e exibir recursos. O IDE impede que você escreva o código diretamente nos "blocos protegidos" da view Código-fonte que
contém o código gerado pelo GUI Builder. No entanto, você pode inserir o código nos blocos protegidos usando os editores de
propriedades que podem ser acessados na janela Propriedades. Ao usar os editores de propriedades desta forma, você garante
que o código personalizado não se perda ao fazer alterações de design no GUI Builder.
Por exemplo, para escrever o código personalizado de uma propriedade icon do JLabel:
3. Na lista drop-down da parte superior da caixa de diálogo, selecione a opção Código Personalizado.
A opção Código Personalizado deste editor de propriedades permite que você mesmo preencha o parâmetro do método
setIcon. Você pode preencher este parâmetro com a lógica necessária ou com uma chamada a um método diferente que você
escreveu em outro lugar na classe.
Resumo
Este tutorial mostrou como acessar imagens de uma aplicação que você criou no NetBeans IDE. O tratamento de imagens é
abordado posteriormente no Tutorial do Java.
Observação: o exemplo oferecido neste tutorial é muito semelhante ao primeiro exemplo na seção Como Usar Ícones do
Tutorial do Java. A diferença é que o código gerado neste tutorial usa o método setIcon do JLabel para aplicar o ícone
no label. No exemplo do Tutorial do Java, o ícone é aplicado no label ao ser passado pelo seu construtor.
https://netbeans.org/kb/docs/java/gui-image-display_pt_BR.html 8/9
11/10/2019 Tratando Imagens em uma Aplicação Java GUI - Tutorial do NetBeans IDE
Consulte Também
Introdução à Construção de GUIs
About Us
https://netbeans.org/kb/docs/java/gui-image-display_pt_BR.html 9/9