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

Nesta etapa, você faz com que o botão Mostrar uma imagem funcione da seguinte forma:

  • Quando um usuário escolhe esse botão, o aplicativo abre uma OpenFileDialog caixa.

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

O IDE tem uma ferramenta poderosa chamada IntelliSense que ajuda você a gravar código. Conforme você digita o código, o IDE abre uma caixa com preenchimentos sugeridos para palavras parciais que você insinuou.

O IntelliSense tenta determinar o que você deseja fazer em seguida e vai 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 escrever código para o manipulador de eventos do botão Mostrar uma imagem

  1. Acesse o Designer de Formulários do Windows e clique duas vezes no botão Mostrar uma imagem. O IDE vai imediatamente para o designer de código e move o cursor para que ele seja dentro do showButton_Click() método (como alternativa, ) que ShowButton_Click() você adicionou anteriormente.

  2. Digite um 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 é aberta, conforme mostrado na imagem a seguir.

    IntelliSense com o código do Visual C#

    Observação

    Seu código pode não exibir manipuladores de eventos em letras "camelCase".

  3. A janela do IntelliSense deve realçar a palavra if . (Caso não, insira um em letras minúsculas f e ele fará isso.) Observe como uma caixa de dica de ferramenta ao lado da janela do IntelliSense aparece com a descrição, snippet de código para a instrução if . (No Visual Basic, a dica de ferramenta também declara que esse é um snippet, mas com um texto ligeiramente diferente.) Você deseja usar esse snippet, portanto, escolha a tecla Tab para inserir em if seu código. Em seguida, pressione a tecla Tab novamente para usar o snippet if. (Se você pressionou outro item e sua janela do IntelliSense desapareceu, apague i e o digite novamente, e a janela do IntelliSense será reaberta).

    Código do Visual C#

Usar o IntelliSense para inserir mais código

Em seguida, use o IntelliSense para inserir mais código para abrir uma caixa de diálogo Abrir Arquivo. Se o usuário escolheu 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 haja muitas etapas, são apenas alguns teclas:

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

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

    Para saber mais sobre OpenFileDialog, consulte OpenFileDialog.

  3. Digite um ponto ( . ) (Muitos programadores chamam isso de ponto.) Como você digitou um ponto logo após openFileDialog1, uma janela do IntelliSense é aberta, preenchida com todas as propriedades e métodos do componente OpenFileDialog. Estas são as mesmas propriedades exibidas na janela Propriedades quando você a escolhe no Designer de Formulários do Windows. 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 do IntelliSense pode mostrar propriedades e métodos. Para determinar o que está sendo mostrado, veja o ícone à esquerda de cada item na janela do IntelliSense. Você vê uma imagem de um bloco ao lado de cada método e uma imagem de uma chave inglesa (ou chave de fenda) ao lado de cada propriedade. Há também um ícone de raio ao lado de cada evento.

    Aqui estão os ícones que aparecem:

    Ícone de método
    Ícone de propriedade
    Ícone de evento

  4. Comece digitando ShowDialog (as letras maiúsculas não são importantes para o IntelliSense). O método ShowDialog() exibirá a caixa de diálogo Abrir Arquivo. Depois que a janela tiver realçado ShowDialog, pressione a tecla Tab. Você também pode realçar "ShowDialog" e escolher a tecla F1 para obter ajuda com isso.

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

  5. Ao usar um método em um controle ou em um componente (conhecido como chamando um método), é necessário adicionar parênteses. Assim, insira parênteses de abertura e fechamento imediatamente após o “g” em ShowDialog: () Agora isso terá a aparência "openFileDialog1.ShowDialog()".

    Observação

    Os métodos são uma parte importante de qualquer aplicativo e este tutorial mostrou várias maneiras de usar métodos. É possível chamar o método de um componente para pedir que ele faça algo, da mesma forma como você chamou o método ShowDialog() do componente OpenFileDialog. Você pode criar seus próprios métodos para fazer com que seu aplicativo faça coisas, como aquela que você está criando agora, chamada de método , que abre uma caixa de diálogo e uma imagem quando um usuário escolhe showButton_Click() um botão.

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

  7. Adicionar outro espaço. Assim que fizer isso, outra janela do IntelliSense será aberta. Comece digitando DialogResult e pressione 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 OpenFileDialog pode resultar em o usuário escolher OK ou Cancelar. Portanto, seu método ShowDialog() retorna DialogResult.OK ou DialogResult.Cancel.

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

    Para saber mais sobre DialogResult, veja DialogResult.

    Observação

    A primeira linha de código deve ser preenchida. Para C#, ele deve ser semelhante ao 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. Seu método showButton_Click() final deve ser semelhante ao código a seguir.

    Importante

    Use o controle linguagem de programação no canto superior direito desta página para exibir o trecho de código C# ou o trecho de código de Visual Basic.

    Controle de linguagem de programação para Docs.Microsoft.com

    private void showButton_Click(object sender, EventArgs e)
    {
        if (openFileDialog1.ShowDialog() == DialogResult.OK)
        {
            pictureBox1.Load(openFileDialog1.FileName);  
        }
    }
    
    Private Sub showButton_Click() Handles showButton.Click
        If OpenFileDialog1.ShowDialog() = DialogResult.OK Then
            PictureBox1.Load(OpenFileDialog1.FileName)
        End If
    
    End Sub
    

Próximas etapas

Confira também