Etapa 9: Revisar, comentar e testar o código

Em seguida, adicione um comentário ao seu código.Um comentário é uma observação que não modifica a maneira que o programa se comporta.Facilita para alguém que esteja lendo o código para entender o que ele faz.Recomendamos que você tenha o hábito de adicionar comentários ao seu código.No Visual C#, duas barras (//) marcam uma linha como um comentário.No Visual Basic, aspas simples (') são usadas para marcar uma linha como um comentário.Após adicionar um comentário, teste seu programa.É uma prática recomendável executar e testar seu código com frequência enquanto trabalha em seus projetos e, portanto, você pode capturar e corrigir os problemas no início, antes que o código fique mais complicado.Isso é chamado de teste iterativo.

Você acabou de criar algo que funciona e que, embora ainda não esteja pronto, já pode carregar uma imagem.Antes de adicionar um comentário ao seu código e testá-lo, leva tempo para examinar os conceitos de código, pois você usará esses conceitos frequentemente:

• Quando você clica duas vezes no botão Mostrar uma imagem no designer do Windows Forms, o IDE adiciona automaticamente um método para o código do seu programa.

• Os métodos são a forma como você organiza seu código: é como o código é agrupado.

• Na maioria das vezes, um método faz um pequeno número de coisas em uma ordem específica, como a forma como o seu método showButton_Click() mostra uma caixa de diálogo e carrega uma imagem.

• Um método é composto por declaraçõesde código, ou linhas de código.Pense em um método como uma maneira de empacotar as instruções de código juntas.

• Quando um método é executado, ou chamado, as instruções no método são excluídas em ordem, uma após a outra, começando com a primeira.

  A seguir veja um exemplo de uma declaração.

  pictureBox1.Load(openFileDialog1.FileName);
  

  pictureBox1.Load(openFileDialog1.FileName)
  

  As instruções fazem com que seus programas funcionem.No Visual C#, uma instrução sempre termina em um ponto-e-vírgula.No Visual Basic, o final de uma linha é o fim de uma declaração. (Nenhuma vírgula é necessária no Visual Basic.) A instrução anterior diz ao controle PictureBox para carregar o arquivo que o usuário selecionou com o componente OpenFileDialog.

Para uma versão de vídeo deste tópico, consulte o Tutorial 1: Criar um Visualizador de Imagens no Visual Basic - Vídeo 5 ou o Tutorial 1: Criar um Visualizador de Imagens em C# - Vídeo 5.Esses vídeos usam uma versão anterior do Visual Studio, portanto, existem pequenas diferenças em alguns comandos de menu e em outros elementos da interface do usuário.No entanto, os conceitos e procedimentos funcionam de maneiras semelhantes na versão atual do Visual Studio.

Para adicionar comentários

1. Adicione o seguinte comentário ao seu código.

   Private Sub showButton_Click() Handles showButton.Click
   
       ' Show the Open File dialog. If the user clicks OK, load the 
       ' picture that the user chose. 
       If OpenFileDialog1.ShowDialog() = DialogResult.OK Then
           PictureBox1.Load(OpenFileDialog1.FileName)
       End If 
   
   End Sub
   

   private void showButton_Click(object sender, EventArgs e)
   {
       // Show the Open File dialog. If the user clicks OK, load the 
       // picture that the user chose. 
       if (openFileDialog1.ShowDialog() == DialogResult.OK)
       {
           pictureBox1.Load(openFileDialog1.FileName);
       }
   }
   

   Observação

   O manipulador de eventos de clique do botão de showButton foi concluído e funciona.Você começou a escrever código, começando com uma instrução if.Uma instrução if é como você dizer a seu programa, "Verifique isso, e se for verdadeiro, faça o seguinte". Nesse caso, você informa o programa para abrir a caixa de diálogo Abrir Arquivo e, se o usuário selecionar um arquivo e escolher o botão OK, carregue o arquivo na PictureBox.

   Dica

   O IDE é criado para tornar a gravação do código mais fácil, e os trechos de código são uma maneira que ele usa para fazer isso.Um trecho é um atalho que é expandido em um pequeno bloco de código. Você pode ver todos os trechos disponíveis.Na barra de menus, escolha Ferramentas, Gerenciador de Trechos de Código.Para o Visual c#, o trecho if está no Visual C#.Para o Visual Basic, os trechos if estão em Condicionais e Loops, Padrões de Código.Você pode usar esse aplicativo para procurar por trechos existentes ou para adicionar seus próprios trechos. Para ativar um trecho ao digitar o código, digite-o e pressione a tecla TAB.Muitos trechos aparecem na janela IntelliSense, e é por isso que você escolhe a tecla TAB duas vezes: primeiro para selecionar o trecho na janela IntelliSense e depois para mandar o IDE para usar o trecho. (O IntelliSense oferece suporte a trechos de if, mas não a trechos de ifelse.)

2. Antes de executar o programa, salve seu programa clicando no botão Salvar todos na barra de ferramentas, que aparece da seguinte forma.

   Botão Salvar todos

   

   Como alternativa para salvar seu programa, na barra de menus, escolha Arquivo, Salvar todos.É uma prática recomendada salvar no início e com frequência.

   Quando estiver em execução, seu programa deve estar como a imagem a seguir.

   Visualizador de imagem

   

Para testar o programa

1. Escolha a tecla F5 ou escolha o botão da barra de ferramentas Iniciar Depuração.

2. Escolha o botão Mostrar uma imagem para executar o código que você acabou de escrever.Primeiro, o programa abre uma caixa de diálogo Abrir Arquivo.Verifique se seus filtros aparecem na lista suspensa Arquivos de tipo na parte inferior da caixa de diálogo.Em seguida, navegue para uma imagem e abra-a.Geralmente você pode localizar as imagens de exemplo fornecidas com o sistema operacional Windows em sua pasta de Meus Documentos, dentro da pasta My Pictures\Sample Pictures.

   Observação
   Se você não vir quaisquer imagens na caixa de diálogo Selecione um arquivo de imagem, certifique-se de que o filtro "Todos os arquivos (*.*)" esteja selecionado na lista suspensa no canto inferior direito da caixa de diálogo.

3. Carregue uma imagem e ela aparecerá em sua PictureBox.Tente redimensionar o formulário arrastando suas bordas.Como você tem seu PictureBox inserido em um TableLayoutPanel, que está inserido no formulário, sua área de imagem irá se redimensionar de modo que seja tão larga quando o formulário, e preencherá 90 por cento da parte superior do formulário.É por isso que você usou os recipientes TableLayoutPanel e FlowLayoutPanel: eles mantêm seu formato dimensionado corretamente quando o usuário o redimensiona.

   Agora, imagens maiores vão além das bordas do visualizador de imagens.Na próxima etapa, você adicionará código para fazer as imagens caberem na janela.

Para continuar ou revisar

• Para ir para a próxima etapa do tutorial, consulte Etapa 10: Escrever código para botões adicionais e uma caixa de seleção.

• Para retornar à etapa anterior do tutorial, consulte Etapa 8: Escrever código para o manipulador de eventos do botão Mostrar uma Imagem.