ListBox.IndexFromPoint Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Retorna o índice baseado em zero do item nas coordenadas especificadas.

Sobrecargas

Nome	Description
IndexFromPoint(Point)	Retorna o índice baseado em zero do item nas coordenadas especificadas.
IndexFromPoint(Int32, Int32)	Retorna o índice baseado em zero do item nas coordenadas especificadas.

IndexFromPoint(Point)

Origem:

ListBox.cs

Retorna o índice baseado em zero do item nas coordenadas especificadas.

public:
 int IndexFromPoint(System::Drawing::Point p);

public int IndexFromPoint(System.Drawing.Point p);

member this.IndexFromPoint : System.Drawing.Point -> int

Public Function IndexFromPoint (p As Point) As Integer

Parâmetros

p

Point

Um Point objeto que contém as coordenadas usadas para obter o índice de item.

Retornos

Int32

O índice baseado em zero do item encontrado nas coordenadas especificadas; retornará ListBox.NoMatches se nenhuma correspondência for encontrada.

Exemplos

O exemplo de código a seguir demonstra como executar operações de arrastar e soltar usando um ListBox controle que contém itens a serem removidos em um RichTextBox controle. O construtor do formulário define a AllowDrop propriedade para true habilitar a ocorrência de operações de arrastar e soltar no RichTextBox. O exemplo usa o MouseDown evento do ListBox para iniciar a operação de arrastar chamando o DoDragDrop método. O exemplo usa o DragEnter evento para determinar se um item que está sendo arrastado para o RichTextBox tipo de dados é válido. O DragDrop evento executa a remoção real de um item arrastado para o RichTextBox controle no local atual do cursor dentro do RichTextBox. Este exemplo requer que os eventos e os DragDrop eventos DragEnter tenham sido conectados aos manipuladores de eventos definidos no exemplo.

public:
   Form1()
   {
      InitializeComponent();
      
      // Sets the control to allow drops, and then adds the necessary event handlers.
      this->richTextBox1->AllowDrop = true;
   }

private:
   void listBox1_MouseDown( Object^ sender, System::Windows::Forms::MouseEventArgs^ e )
   {
      // Determines which item was selected.
      ListBox^ lb = (dynamic_cast<ListBox^>(sender));
      Point pt = Point(e->X,e->Y);

      //Retrieve the item at the specified location within the ListBox.
      int index = lb->IndexFromPoint( pt );

      // Starts a drag-and-drop operation.
      if ( index >= 0 )
      {
         // Retrieve the selected item text to drag into the RichTextBox.
         lb->DoDragDrop( lb->Items[ index ]->ToString(), DragDropEffects::Copy );
      }
   }

   void richTextBox1_DragEnter( Object^ /*sender*/, DragEventArgs^ e )
   {
      // If the data is text, copy the data to the RichTextBox control.
      if ( e->Data->GetDataPresent( "Text" ) )
            e->Effect = DragDropEffects::Copy;
   }

   void richTextBox1_DragDrop( Object^ /*sender*/, DragEventArgs^ e )
   {
      // Paste the text into the RichTextBox where at selection location.
      richTextBox1->SelectedText = e->Data->GetData( "System.String", true )->ToString();
   }

public Form1()
{
   InitializeComponent();
   // Sets the control to allow drops, and then adds the necessary event handlers.
   this.richTextBox1.AllowDrop = true;
}
 
private void listBox1_MouseDown(object sender, System.Windows.Forms.MouseEventArgs e)
{
   // Determines which item was selected.
   ListBox lb =( (ListBox)sender);
   Point pt = new Point(e.X,e.Y);
   //Retrieve the item at the specified location within the ListBox.
   int index = lb.IndexFromPoint(pt);

   // Starts a drag-and-drop operation.
   if(index>=0) 
   {
      // Retrieve the selected item text to drag into the RichTextBox.
      lb.DoDragDrop(lb.Items[index].ToString(), DragDropEffects.Copy);
   }
}

private void richTextBox1_DragEnter(object sender, DragEventArgs e)
{
   // If the data is text, copy the data to the RichTextBox control.
   if(e.Data.GetDataPresent("Text"))
      e.Effect = DragDropEffects.Copy;
}

private void richTextBox1_DragDrop(object sender, DragEventArgs e) 
{
   // Paste the text into the RichTextBox where at selection location.
   richTextBox1.SelectedText =  e.Data.GetData("System.String", true).ToString();
}

Public Sub New()
   MyBase.New()

   'This call is required by the Windows Form Designer.
   InitializeComponent()

   richTextBox1.AllowDrop = True

End Sub

Private Sub listBox1_MouseDown(ByVal sender As Object, ByVal e As System.Windows.Forms.MouseEventArgs) Handles listBox1.MouseDown
   ' Determines which item was selected.
   Dim lb As ListBox = CType(sender, ListBox)
   Dim pt As New Point(e.X, e.Y)
   'Retrieve the item at the specified location within the ListBox.
   Dim index As Integer = lb.IndexFromPoint(pt)

   ' Starts a drag-and-drop operation.
   If index >= 0 Then
      ' Retrieve the selected item text to drag into the RichTextBox.
      lb.DoDragDrop(lb.Items(index).ToString(), DragDropEffects.Copy)
   End If
End Sub


Private Sub richTextBox1_DragEnter(ByVal sender As Object, ByVal e As DragEventArgs) Handles richTextBox1.DragEnter
   ' If the data is text, copy the data to the RichTextBox control.
   If e.Data.GetDataPresent("Text") Then
      e.Effect = DragDropEffects.Copy
   End If
End Sub

Private Sub richTextBox1_DragDrop(ByVal sender As Object, ByVal e As DragEventArgs) Handles richTextBox1.DragDrop
   ' Paste the text into the RichTextBox where at selection location.
   richTextBox1.SelectedText = e.Data.GetData("System.String", True).ToString()
End Sub

Comentários

Esse método permite determinar qual item está localizado em um local específico dentro do controle. Você pode usar esse método para determinar qual item dentro da lista é selecionado quando um usuário clica com o botão direito do mouse no ListBox. O local do cursor pode ser determinado e passado para o p parâmetro do IndexFromPoint método para determinar qual item o usuário clicou com o botão direito do mouse. Em seguida, você pode exibir um menu de atalho para o usuário para fornecer tarefas e recursos com base no item específico.

IndexFromPoint(Int32, Int32)

Origem:

ListBox.cs

Retorna o índice baseado em zero do item nas coordenadas especificadas.

public:
 int IndexFromPoint(int x, int y);

public int IndexFromPoint(int x, int y);

member this.IndexFromPoint : int * int -> int

Public Function IndexFromPoint (x As Integer, y As Integer) As Integer

Parâmetros

x

Int32

A coordenada x do local a ser pesquisado.

y

Int32

A coordenada y do local a ser pesquisado.

Retornos

Int32

O índice baseado em zero do item encontrado nas coordenadas especificadas; retornará ListBox.NoMatches se nenhuma correspondência for encontrada.

Exemplos

O exemplo de código a seguir demonstra como executar operações de arrastar e soltar usando um ListBox controle que contém itens a serem removidos em um RichTextBox controle. O construtor do formulário define a AllowDrop propriedade para true habilitar a ocorrência de operações de arrastar e soltar no RichTextBox. O exemplo usa o MouseDown evento do ListBox para iniciar a operação de arrastar chamando o DoDragDrop método. O exemplo usa o DragEnter evento para determinar se um item que está sendo arrastado para o RichTextBox tipo de dados é válido. O DragDrop evento executa a remoção real de um item arrastado para o RichTextBox controle no local atual do cursor dentro do RichTextBox. Este exemplo requer que os eventos e os DragDrop eventos DragEnter tenham sido conectados aos manipuladores de eventos definidos no exemplo.

public:
   Form1()
   {
      InitializeComponent();
      
      // Sets the control to allow drops, and then adds the necessary event handlers.
      this->richTextBox1->AllowDrop = true;
   }

private:
   void listBox1_MouseDown( Object^ sender, System::Windows::Forms::MouseEventArgs^ e )
   {
      // Determines which item was selected.
      ListBox^ lb = (dynamic_cast<ListBox^>(sender));
      Point pt = Point(e->X,e->Y);

      //Retrieve the item at the specified location within the ListBox.
      int index = lb->IndexFromPoint( pt );

      // Starts a drag-and-drop operation.
      if ( index >= 0 )
      {
         // Retrieve the selected item text to drag into the RichTextBox.
         lb->DoDragDrop( lb->Items[ index ]->ToString(), DragDropEffects::Copy );
      }
   }

   void richTextBox1_DragEnter( Object^ /*sender*/, DragEventArgs^ e )
   {
      // If the data is text, copy the data to the RichTextBox control.
      if ( e->Data->GetDataPresent( "Text" ) )
            e->Effect = DragDropEffects::Copy;
   }

   void richTextBox1_DragDrop( Object^ /*sender*/, DragEventArgs^ e )
   {
      // Paste the text into the RichTextBox where at selection location.
      richTextBox1->SelectedText = e->Data->GetData( "System.String", true )->ToString();
   }

public Form1()
{
   InitializeComponent();
   // Sets the control to allow drops, and then adds the necessary event handlers.
   this.richTextBox1.AllowDrop = true;
}
 
private void listBox1_MouseDown(object sender, System.Windows.Forms.MouseEventArgs e)
{
   // Determines which item was selected.
   ListBox lb =( (ListBox)sender);
   Point pt = new Point(e.X,e.Y);
   //Retrieve the item at the specified location within the ListBox.
   int index = lb.IndexFromPoint(pt);

   // Starts a drag-and-drop operation.
   if(index>=0) 
   {
      // Retrieve the selected item text to drag into the RichTextBox.
      lb.DoDragDrop(lb.Items[index].ToString(), DragDropEffects.Copy);
   }
}

private void richTextBox1_DragEnter(object sender, DragEventArgs e)
{
   // If the data is text, copy the data to the RichTextBox control.
   if(e.Data.GetDataPresent("Text"))
      e.Effect = DragDropEffects.Copy;
}

private void richTextBox1_DragDrop(object sender, DragEventArgs e) 
{
   // Paste the text into the RichTextBox where at selection location.
   richTextBox1.SelectedText =  e.Data.GetData("System.String", true).ToString();
}

Public Sub New()
   MyBase.New()

   'This call is required by the Windows Form Designer.
   InitializeComponent()

   richTextBox1.AllowDrop = True

End Sub

Private Sub listBox1_MouseDown(ByVal sender As Object, ByVal e As System.Windows.Forms.MouseEventArgs) Handles listBox1.MouseDown
   ' Determines which item was selected.
   Dim lb As ListBox = CType(sender, ListBox)
   Dim pt As New Point(e.X, e.Y)
   'Retrieve the item at the specified location within the ListBox.
   Dim index As Integer = lb.IndexFromPoint(pt)

   ' Starts a drag-and-drop operation.
   If index >= 0 Then
      ' Retrieve the selected item text to drag into the RichTextBox.
      lb.DoDragDrop(lb.Items(index).ToString(), DragDropEffects.Copy)
   End If
End Sub


Private Sub richTextBox1_DragEnter(ByVal sender As Object, ByVal e As DragEventArgs) Handles richTextBox1.DragEnter
   ' If the data is text, copy the data to the RichTextBox control.
   If e.Data.GetDataPresent("Text") Then
      e.Effect = DragDropEffects.Copy
   End If
End Sub

Private Sub richTextBox1_DragDrop(ByVal sender As Object, ByVal e As DragEventArgs) Handles richTextBox1.DragDrop
   ' Paste the text into the RichTextBox where at selection location.
   richTextBox1.SelectedText = e.Data.GetData("System.String", True).ToString()
End Sub

Comentários

Esse método permite determinar qual item está localizado em um local específico dentro do controle. Você pode usar esse método para determinar qual item dentro da lista é selecionado quando um usuário clica com o botão direito do mouse no ListBox. O local do cursor pode ser determinado e passado para os parâmetros e y parâmetros xIndexFromPoint do método para determinar qual item o usuário clicou com o botão direito do mouse. Em seguida, você pode exibir um menu de atalho para o usuário para fornecer tarefas e recursos com base no item específico.