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

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 objeto Point que contém as coordenadas usadas para obter o índice do 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 para soltar em um RichTextBox controle . O construtor do formulário define a AllowDrop propriedade como para true permitir que as operações de arrastar e soltar ocorram 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 é um 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 DragDrop eventos e 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 que você determine 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 para soltar em um RichTextBox controle . O construtor do formulário define a AllowDrop propriedade como para true permitir que as operações de arrastar e soltar ocorram 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 é um 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 DragDrop eventos e 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 que você determine 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 x parâmetros e y 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.