Etapa 8: Escrever código para o manipulador de eventos do botão Mostrar uma Imagem

Nesta etapa, você faz o botão Mostrar uma imagem funcionar desta forma:

• Quando um usuário escolher o botão, o programa abre uma caixa de diálogo Abrir Arquivo.

• Se um usuário abrir um arquivo de imagem, o programa mostrará essa imagem em PictureBox.

O IDE tem uma ferramenta poderosa chamada IntelliSense que ajuda você a gravar código.À medida que você insere o código, a IDE abre uma caixa com conclusões sugeridas para as palavras parciais que você insere.Tenta determinar o que você deseja fazer em seguida e pula automaticamente para o último item escolhido na lista.Você pode usar as setas para cima ou para abaixo para mover na lista, ou continuar digitando letras para refinar as opções.Ao ver a opção que deseja, escolha a tecla TAB para selecioná-la.Ou, você pode ignorar as sugestões, se não forem necessárias.

Para uma versão de vídeo deste tópico, consulte o Tutorial 1: Criar um Visualizador de Imagens no Visual Basic - Vídeo 4 ou o Tutorial 1: Criar um Visualizador de Imagens em C# - Vídeo 4.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 escrever código para o manipulador de eventos do botão Mostrar uma imagem

1. Vá para o Designer do Windows Forms e clique duas vezes no botão Mostrar uma imagem.O IDE aparece imediatamente para o designer de código e move o cursor para que esteja dentro do método showButton_Click() que você adicionou anteriormente.

2. Digite i na linha vazia entre as duas chaves { }. (No Visual Basic, digite na linha vazia entre Private Sub… e End Sub.) Uma janela do IntelliSense abre, conforme mostrado na seguinte imagem.

   IntelliSense com código do Visual C#

   

3. A janela IntelliSense deve estar realçando a palavra se. (Se não, digite um fem minúsculo, e será feito.) Observe como uma pequena caixa de dica de ferramenta próxima à janela do IntelliSense aparece com a descrição, Trecho de código para instrução if. (No Visual Basic, a dica de ferramenta também indica que este é um trecho de código, mas com palavras ligeiramente diferentes.) Você deseja usar o trecho de código, então escolha a tecla TAB para inserir se em seu código.Escolha a tecla TAB novamente para usar o trecho se. (Se você escolheu em outro lugar e a janela IntelliSense desapareceu, retorne para i e o digite novamente, e a janela IntelliSense abrirá novamente.)

   Código Visual C#

   

4. Em seguida, você usa o IntelliSense para inserir mais código para abrir uma caixa de diálogo Abrir Arquivo.Se o usuário escolher o botão OK, a PictureBox carrega o arquivo selecionado pelo usuário.As etapas a seguir mostram como inserir o código e, embora sejam várias etapas, são apenas alguns pressionamentos de teclas:

   1. Comece com o texto selecionado true no trecho.Digite op para substituí-lo. (No Visual Basic, você começa com um argumento inicial, portanto, digite Op.)

   2. A janela IntelliSense é aberta e exibe openFileDialog1.Escolha a tecla TAB para selecioná-lo. (No Visual Basic, começa com um argumento inicial, portanto, você vê OpenFileDialog1.Certifique-se de que OpenFileDialog1 esteja selecionado).

      Para saber mais sobre OpenFileDialog, consulte OpenFileDialog.

   3. Digite um ponto (.) (Muitos desenvolvedores chamam isso de ponto.) Como você digitou um ponto logo após openFileDialog1, uma janela do IntelliSense abre, preenchida com todas as propriedades e métodos de componente de OpenFileDialog.Estas são as mesmas propriedades que aparecem na janela Propriedades quando você a escolhe no Windows Forms Designer.Você também pode escolher os métodos que demandam que o componente faça coisas (como abrir uma caixa de diálogo).

      Observação
      A janela IntelliSense pode mostrar propriedades e métodos.Para determinar o que está sendo mostrado, veja o ícone no lado esquerdo de cada item na janela IntelliSense.Você verá uma imagem de um bloco ao lado de cada método, e uma imagem de uma chave (ou de chave em inglês) ao lado de cada propriedade.Há também um ícone de raio ao lado de cada evento.Essas imagens são exibidas como se segue.

      Ícone de método

      

      Ícone de propriedade

      

      Ícone de evento

      

   4. Comece a digitar ShowDialog (as letras maiúsculas não são importantes para o IntelliSense).O método de ShowDialog() mostrará a caixa de diálogo Abrir Arquivo.Após a janela ter destacado ShowDialog, pressione a tecla TAB.Você também pode realçar “ShowDialog” e escolher a tecla F1 para obter ajuda para ele.

      Para saber mais sobre o método ShowDialog(), consulte o Método ShowDialog.

   5. Ao usar um método em um controle ou componente (conhecido como chamar um método), você precisa adicionar parênteses.Assim, insira os parêntesis de abertura e fechamento imediatamente após o "g" em ShowDialog: () Agora, a aparência deve ser "openFileDialog1.ShowDialog()".

      Observação

      Os métodos são uma parte importante de qualquer programa, e este tutorial mostrou várias maneiras de usar métodos.Você pode chamar o método de um componente para que ele faça algo, como você chamou o método de OpenFileDialog do componente ShowDialog().Você pode criar seus próprios métodos para fazer seu programa executar ações, como aquela que você está compilando agora, chamado método showButton_Click(), que abre um caixa de diálogo e uma imagem quando um usuário escolhe um botão.

   6. Para o Visual C#, adicione um espaço e então adicione dois sinais de igual (==).Para o Visual Basic, adicione um espaço e então use um único sinal de igual (=). (O Visual C# e Visual Basic usam operadores de igualdade diferentes.)

   7. Adicionar outro espaço.Assim que fizer isso, outra janela do IntelliSense abre.Comece a digitar DialogResult e escolha a tecla TAB para adicioná-lo.

      Observação

      Quando você escreve um código para chamar um método, ele às vezes retorna um valor.Nesse caso, o método ShowDialog() do componente OpenFileDialog retorna um valor DialogResult.DialogResult é um valor especial que indica o que acontecem em uma caixa de diálogo.Um componente de OpenFileDialog pode fazer com que o usuário selecione OK ou Cancelar, então o método de ShowDialog() retorna DialogResult.OK ou DialogResult.Cancel.

   8. Digite um ponto para abrir a janela IntelliSense de valor DialogResult.Insira a letra O e escolha a tecla TAB para inserir OK.

      Para saber mais sobre DialogResult, consulte DialogResult.

      Observação
      A primeira linha de código deve ser preenchida.Para o Visual C#, deve ser o seguinte. if (openFileDialog1.ShowDialog() == DialogResult.OK) Para o Visual Basic, deve ser o seguinte. If OpenFileDialog1.ShowDialog() = DialogResult.OK Then

   9. Agora adicione mais uma linha de código.Você pode digitar (ou copiar e colar), mas considere usar o IntelliSense para adicioná-lo.Quanto mais familiarizado você estiver com o IntelliSense, mais rapidamente você poderá escrever seu próprio código.O método final de showButton_Click() parece com o seguinte. (Escolha a guia VB para exibir a versão de Visual Basic do código.)

      Private Sub showButton_Click() Handles showButton.Click
          If OpenFileDialog1.ShowDialog() = DialogResult.OK Then
              PictureBox1.Load(OpenFileDialog1.FileName)
          End If 
      
      End Sub
      

      private void showButton_Click(object sender, EventArgs e)
      {
          if (openFileDialog1.ShowDialog() == DialogResult.OK)
          {
              pictureBox1.Load(openFileDialog1.FileName);  
          }
      }
      

Para continuar ou revisar

• Para ir para a próxima etapa do tutorial, consulte Etapa 9: Revisar, comentar e testar o código.

• Para retornar à etapa anterior do tutorial, consulte Etapa 7: Adicionar componentes de diálogo ao formulário.