Como fornecer funcionalidade de arrastar-e-soltar de arquivo em um aplicativo Visual Basic 2005 ou Visual Basic .NET

O procedimento neste artigo passo a passo demonstra como fornecer funcionalidade de arrastar-e-soltar de arquivo em um aplicativo Microsoft Visual Basic .NET ou Microsoft Visual Basic 2005. Um controle ListBox é usado como o destino do procedimento de arrastar-e-soltar arquivo.

Requisitos

A lista a seguir descreve o hardware recomendado, software, infra-estrutura de rede e service packs que você precisa:

• Visual Basic 2005 ou o Visual Basic .NET

Este artigo pressupõe que você esteja familiarizado com os seguintes tópicos:

• Controle ListBox do Windows Forms
• Tratamento de evento do Windows Forms

Etapas para criar o exemplo

O controle ListBox fornece dois eventos de arrastar-e-soltar que você precisa manipular: DragEnter e DragDrop . O evento DragEnter ocorre quando você arrasta um objeto dentro dos limites do controle e é usada para determinar se o objeto que está sendo arrastado é aquele que você deseja permitir para ser solto no controle. Tratar este evento para casos em que um ou mais arquivos são arrastados para o controle. Isso permite que o ícone apropriado a ser exibido quando o objeto é arrastado sobre o controle, dependendo do objeto que está sendo arrastado. O evento DragDrop ocorre quando o objeto que está sendo arrastado foi lançado no controle. Tratar este evento para recuperar o objeto. O objeto de dados é usado para recuperar os dados.

GetData método do objeto de dados retorna uma matriz de seqüências de caracteres que contêm os nomes de caminho completo dos arquivos que foram arrastados para o controle ListBox . Você pode usar essas informações de caminho de arquivo para executar quaisquer operações são necessários nos arquivos. Por exemplo, você pode usar classes no namespace System.IO para abrir e ler os arquivos, mova os arquivos, ou copiar os arquivos para um novo local. Este exemplo adiciona apenas o caminho completo para os arquivos são arrastados para o controle ListBox .

Para fornecer funcionalidade de arrastar-e-soltar de arquivo em um aplicativo Visual Basic .NET ou Visual Basic 2005, siga estas etapas:

1. Crie um aplicativo do novo Windows Forms no Visual Basic 2005 ou Visual Basic. NET. O Form1 é criado por padrão.
2. Use a caixa de ferramentas para adicionar um controle ListBox ao Form1.
3. Na janela Properties, altere a propriedade AllowDrop do controle ListBox para True para permitir que objetos para ser arrastado para o controle.
4. No Solution Explorer, clique com o botão direito do mouse no Form1 e, em seguida, clique em View Code .
5. Para manipular o evento DragEnter , adicione o seguinte método abaixo da seção de código que o Windows Form Designer gera na classe Form1:

       Private Sub ListBox1_DragEnter(ByVal sender As Object, _
                                      ByVal e As System.Windows.Forms.DragEventArgs) _
                                      Handles ListBox1.DragEnter
           If (e.Data.GetDataPresent(DataFormats.FileDrop)) Then
               e.Effect = DragDropEffects.All
           Else
               e.Effect = DragDropEffects.None
           End If
       End Sub
   					

6. Para manipular o evento DragDrop , adicione o seguinte método à classe Form1 imediatamente após o método que você adicionou na etapa 5:

       Private Sub ListBox1_DragDrop(ByVal sender As Object, _
                                     ByVal e As System.Windows.Forms.DragEventArgs) _
                                     Handles ListBox1.DragDrop
           Dim s() As String = e.Data.GetData("FileDrop", False)
           Dim i As Integer
           For i = 0 To s.Length - 1
               ListBox1.Items.Add(s(i))
           Next i
       End Sub
   					

7. Criar e executar o projeto.
8. Arrastar um ou mais arquivos na área de trabalho ou outra pasta para o controle ListBox . Observe que o caminho completo dos arquivos é adicionado ao controle ListBox .

Para obter mais informações, visite os seguintes sites da Microsoft Developer Network (MSDN):