ListBox.IndexFromPoint Метод

Определение

Возвращает отсчитываемый от нуля индекс элемента, расположенного по указанным координатам.Returns the zero-based index of the item at the specified coordinates.

Перегрузки

IndexFromPoint(Point)

Возвращает отсчитываемый от нуля индекс элемента, расположенного по указанным координатам.Returns the zero-based index of the item at the specified coordinates.

IndexFromPoint(Int32, Int32)

Возвращает отсчитываемый от нуля индекс элемента, расположенного по указанным координатам.Returns the zero-based index of the item at the specified coordinates.

IndexFromPoint(Point)

Возвращает отсчитываемый от нуля индекс элемента, расположенного по указанным координатам.Returns the zero-based index of the item at the specified coordinates.

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

Параметры

p
Point

Объект Point, содержащий координаты, по которым определяется индекс позиции.A Point object containing the coordinates used to obtain the item index.

Возвращаемое значение

Начинающийся с нуля индекс первой позиции, найденной по заданным координатам; если ни одной позиции не обнаружено, возвращается ListBox.NoMatches.The zero-based index of the item found at the specified coordinates; returns ListBox.NoMatches if no match is found.

Примеры

В следующем примере кода показано, как выполнять операции перетаскивания с помощью элемента управления ListBox, содержащего элементы, которые нужно перетащить в элемент управления RichTextBox.The following code example demonstrates how to perform drag-and-drop operations using a ListBox control that contains items to drop into a RichTextBox control. Конструктор формы задает для свойства AllowDrop значение true, чтобы разрешить операции перетаскивания в RichTextBox.The constructor of the form sets the AllowDrop property to true to enable drag-and-drop operations to occur in the RichTextBox. В примере используется событие MouseDown ListBox для запуска операции перетаскивания путем вызова метода DoDragDrop.The example uses the MouseDown event of the ListBox to start the drag operation by calling the DoDragDrop method. В примере используется событие DragEnter, чтобы определить, является ли элемент, перетаскиваемый в RichTextBox, допустимым типом данных.The example uses the DragEnter event to determine if an item being dragged into the RichTextBox is a valid data type. Событие DragDrop выполняет фактическое удаление перетаскиваемого элемента в элемент управления RichTextBox в текущем положении курсора в RichTextBox.The DragDrop event performs the actual dropping of a dragged item into the RichTextBox control at the current cursor location within the RichTextBox. В этом примере требуется, чтобы события DragDrop и DragEnter были подключены к обработчикам событий, определенным в примере.This example requires that the DragDrop and DragEnter events have been connected to the event handlers defined in the example.

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

Комментарии

Этот метод позволяет определить, какой элемент находится в определенном месте элемента управления.This method enables you to determine which item is located at a specific location within the control. Этот метод можно использовать для определения того, какой элемент в списке выбран, когда пользователь щелкает правой кнопкой мыши ListBox.You can use this method to determine which item within the list is selected when a user right-clicks the ListBox. Положение курсора может быть определено и передано в параметр p метода IndexFromPoint, чтобы определить, какой элемент пользователь щелкнул правой кнопкой мыши.The location of the cursor can be determined and passed to the p parameter of the IndexFromPoint method to determine which item the user right-clicked the mouse over. Затем можно отобразить контекстное меню для пользователя, чтобы указать задачи и компоненты на основе конкретного элемента.You can then display a shortcut menu to the user to provide tasks and features based on the specific item.

IndexFromPoint(Int32, Int32)

Возвращает отсчитываемый от нуля индекс элемента, расположенного по указанным координатам.Returns the zero-based index of the item at the specified coordinates.

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

Параметры

x
Int32

Координата точки поиска по оси X.The x-coordinate of the location to search.

y
Int32

Координата точки поиска по оси Y.The y-coordinate of the location to search.

Возвращаемое значение

Начинающийся с нуля индекс первой позиции, найденной по заданным координатам; если ни одной позиции не обнаружено, возвращается ListBox.NoMatches.The zero-based index of the item found at the specified coordinates; returns ListBox.NoMatches if no match is found.

Примеры

В следующем примере кода показано, как выполнять операции перетаскивания с помощью элемента управления ListBox, содержащего элементы, которые нужно перетащить в элемент управления RichTextBox.The following code example demonstrates how to perform drag-and-drop operations using a ListBox control that contains items to drop into a RichTextBox control. Конструктор формы задает для свойства AllowDrop значение true, чтобы разрешить операции перетаскивания в RichTextBox.The constructor of the form sets the AllowDrop property to true to enable drag-and-drop operations to occur in the RichTextBox. В примере используется событие MouseDown ListBox для запуска операции перетаскивания путем вызова метода DoDragDrop.The example uses the MouseDown event of the ListBox to start the drag operation by calling the DoDragDrop method. В примере используется событие DragEnter, чтобы определить, является ли элемент, перетаскиваемый в RichTextBox, допустимым типом данных.The example uses the DragEnter event to determine if an item being dragged into the RichTextBox is a valid data type. Событие DragDrop выполняет фактическое удаление перетаскиваемого элемента в элемент управления RichTextBox в текущем положении курсора в RichTextBox.The DragDrop event performs the actual dropping of a dragged item into the RichTextBox control at the current cursor location within the RichTextBox. В этом примере требуется, чтобы события DragDrop и DragEnter были подключены к обработчикам событий, определенным в примере.This example requires that the DragDrop and DragEnter events have been connected to the event handlers defined in the example.

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

Комментарии

Этот метод позволяет определить, какой элемент находится в определенном месте в элементе управления.This method enables you to determine which item that is located at a specific location within the control. Этот метод можно использовать для определения того, какой элемент в списке выбран, когда пользователь щелкает правой кнопкой мыши ListBox.You can use this method to determine which item within the list is selected when a user right-clicks the ListBox. Расположение курсора можно определить и передать в x и y параметры метода IndexFromPoint, чтобы определить, какой элемент пользователь щелкнул мышью при щелчке правой кнопкой мыши.The location of the cursor can be determined and passed to the x and y parameters of the IndexFromPoint method to determine which item the user right-clicked the mouse over. Затем можно отобразить контекстное меню для пользователя, чтобы указать задачи и компоненты на основе конкретного элемента.You can then display a shortcut menu to the user to provide tasks and features based on the specific item.

Применяется к