Introduo

A manipulao de imagens em um aplicativo um problema comum para muitos programadores iniciantes em Java. A forma padro de acessar as imagens em um aplicativo Java atravs do mtodo getResource(). Este tutorial mostra como usar o construtor de GUI do IDE para gerar o cdigo a fim de que inclua imagens (e outros recursos) em seu aplicativo. Alm disso, voc aprender como personalizar a forma na qual o IDE gera o cdigo de manipulao de imagens. O aplicativo resultante deste tutorial ser um JFrame simples que contm um JLabel que exibe uma nica imagem.

Criando a do aplicativo
1. 2. Escolha Arquivo > Novo projeto. No Assistente de novo projeto, selecione Java > Aplicativo Java e clique em Prximo. Em Nome do projeto, digite ImageDisplayApp. Desmarque a caixa de verificao Criar classe principal. Certifique-se de que a caixa de verificao Definir como projeto principal esteja selecionada.

3.
4. 5.

6.

Clique em Concluir.

Criando o formulrio do aplicativo

Nesta seo, voc cria o formulrio JFrame e adiciona um JLabel ao formulrio. Para criar o formulrio JFrame: 1. 2. Na janela Projetos, expanda o n ImageDisplayApp. Clique com o boto direito do mouse no n Pacotes de cdigo-fonte e escolha Novo> Formulrio JFrame.

3. 4.
5.

Em Nome da classe, digite ImageDisplay. Em Nome do pacote, digite org.me.myimageapp. Clique em Concluir.

Para adicionar o JLabel:

Na Paleta, selecione o componente Rtulo e arraste-o para o JFrame.

At este momento, o formulrio deveria ser semelhante a imagem seguinte:

Adicionando um pacote na imagem

Ao usar imagens ou outros recursos em um aplicativo, voc normalmente cria um pacote Java separado para os recursos. No seu sistema de arquivos local, um pacote corresponde a uma pasta. Para criar um pacote para a imagem: 1. Na janela Projetos, clique com o boto direito do mouse no n org.me.myimageapp e escolha Novo > Pacote Java.

2.
3.

No Assistente de novo pacote, adicione .resources a org.me.myimageapp para que o novo pacote seja denominado org.me.myimageapp.resources. Clique em Concluir.

Na janela Projetos, voc deveria ver a imagem dentro do pacote org.me.myimageapp.resources.

Exibindo a imagem no rtulo

Neste aplicativo, a imagem ser incorporada em um componente JLabel. Para adicionar a imagem ao rtulo: 1. No Designer de GUI, selecione o rtulo que adicionou ao seu formulrio.

2. 3. 4.

Na janela Propriedades, clique na categoria Propriedades e role at a propriedade icon. Clique no boto de reticncias. Na caixa de dilogo da propriedade icon, clique em Importar ao projeto.

5.

Na seletor de arquivos, v at qualquer imagem que esteja em seu sistema que deseje usar. Em seguida, clique em Prximo.

6.

Na pgina Selecionar pasta de destino do assistente, selecione a pasta resources e clique em Terminar.

Aps clicar em Terminar, o IDE faz o seguinte:

Copia a imagem no seu projeto. Portanto, quando voc constri e distribui o aplicativo, a imagem est includa no arquivo JAR distribuvel. Gera o cdigo na classe ImageDisplay para acessar a imagem. Exibe a sua imagem no rtulo na visualizao Desenho do seu formulrio.

Neste momento, voc pode realizar alguns procedimentos simples para melhorar a aparncia do formulrio, como: Na janela Propriedades, selecione a propriedade text e exclua jLabel1. Tal valor foi gerado pelo construtor de GUI para exibir o texto do rtulo. No entanto, voc est usando o rtulo para exibir uma imagem em vez do texto, de modo que o texto no necessrio.

Arraste o boto para centraliz-lo no formulrio.

Para visualizar o cdigo gerado: 1. 2. 3. No Designer de GUI, clique na aba Cdigo-fonte. Role at linha que diz Cdigo gerado. Clique no sinal de mais (+) esquerda da linha Cdigo gerado para exibir o cdigo que o Designer de GUI gerou. A linha-chave a seguinte:

jLabel1.setIcon(new javax.swing.ImageIcon(getClass().getResource("/org/me/myimageapp/resources /park-sculpture.jpg"))); // NOI18N

Visto que voc usou o Editor de propriedades da propriedade icon do jLabel1, o IDE gerou o mtodo setIcon. O parmetro de tal mtodo contm uma chamada ao mtodogetResource() em uma classe annima interna de ImageIcon. Observe que o caminho gerado da imagem correspondente com sua localizao na estrutura de pacote do aplicativo. Observaes:

Se voc usar a opo 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 o aplicativo no sistema, mas possivelmente no seria exibida ao executar o aplicativo em outro sistema.

O mtodo getResource tambm til para acessar outros tipos de recursos, como arquivos de texto que contm dados que o aplicativo pode precisar usar.

Construindo e executando o aplicativo

Agora que gerou o cdigo para acessar e exibir a imagem, voc pode construir e executar o aplicativo para certificar-se de que a imagem esteja sendo acessada. 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. Alm disso, isso garante que o elemento Main-Class no arquivo JAR do projeto seja gerado quando voc construir o aplicativo. Para definir a classe principal do projeto: 1. Clique com o boto direito do mouse no n do projeto ImageDisplayApp e escolha Propriedades. 2. Na caixa de dilogo Propriedades do projeto, selecione a categoria Executar. Clique no boto Procurar ao lado do campo Classe principal. Em seguida, selecione a classe org.me.myimageapp.ImageDisplay e clique no boto Selecionar classe principal. Para construir o projeto :

3.

Escolha Executar > Limpar e construir projeto principal (Shift-F11).

Voc pode ver os produtos construdos do aplicativo na janela Arquivos. A pasta build contm a classe compilada. A pasta dist contm um arquivo JAR executvel que contm a classe compilada e a imagem.

Para executar o projeto:

Escolha Executar > Executar projeto principal (F6).

Criando cdigo personalizado

Em muitos aplicativos, a imagem exibida no determinada estaticamente como neste exemplo. Por exemplo, a imagem a ser exibida pode ser determinada por algo em que o usurio clica. Se tiver que ser capaz de escolher a imagem a ser exibida programaticamente, voc pode escrever seu prprio cdigo personalizado para acessar e exibir recursos. O IDE impede que voc escreva o cdigo diretamente nos "blocos protegidos" da visualizao Cdigo-fonte que contm o cdigo gerado pelo construtor de GUI. No entanto, voc pode inserir o cdigo nos blocos

protegidos atravs dos editores de propriedades que podem ser acessados atravs da janela Propriedades. Ao usar os editores de propriedades desta forma, voc garante que o cdigo personalizado no se perda ao fazer alteraes de design no construtor de GUI. Por exemplo, para escrever o cdigo personalizado de uma propriedade icon do JLabel: 1. 2. 3. Selecione JLabel na visualizao Desenho ou na janela Inspetor. Na janela Propriedades, clique no boto de reticncias (...) ao lado da propriedade icon. Na lista suspensa da parte superior da caixa de dilogo, selecione a opo Cdigo personalizado.

A opo Cdigo personalizado deste editor de propriedades permite que voc mesmo preencha o parmetro do mtodo setIcon. Voc pode preencher este parmetro com a lgica necessria ou com uma chamada a um mtodo diferente que voc escreveu em outro lugar na classe.

Resumo
Este tutorial mostrou como acessar imagens a partir de um aplicativo que voc criou no NetBeans IDE. A manipulao de imagens abordada mais adiante no Tutorial do Java. Observao: o exemplo oferecido neste tutorial muito semelhante ao primeiro exemplo de Como usar a seo cones do Tutorial do Java. A diferena que o cdigo gerado neste tutorial usa o mtodo setIcon do JLabel para aplicar o cone no rtulo. No exemplo do Tutorial do Java, o cone aplicado no rtulo ao ser passado atravs do seu construtor. Envie-nos seus comentrios