Поделиться через


ListView.HitTest Метод

Определение

Предоставляет сведения об элементе, заданном координатами X и Y.

Перегрузки

HitTest(Point)

Предоставляет сведения об элементе, заданном точкой.

HitTest(Int32, Int32)

Предоставляет сведения об элементе, заданным координатами x и y.

HitTest(Point)

Предоставляет сведения об элементе, заданном точкой.

public:
 System::Windows::Forms::ListViewHitTestInfo ^ HitTest(System::Drawing::Point point);
public System.Windows.Forms.ListViewHitTestInfo HitTest (System.Drawing.Point point);
member this.HitTest : System.Drawing.Point -> System.Windows.Forms.ListViewHitTestInfo
Public Function HitTest (point As Point) As ListViewHitTestInfo

Параметры

point
Point

точка Point, для которой требуется извлечь сведения об элементе. Координаты указываются относительно левого верхнего левого угла элемента управления.

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

Сведения об элементе, заданном точкой.

Исключения

У точки есть отрицательная координата.

Комментарии

Используйте этот метод, чтобы определить, находится ли точка в элементе или подэлементе и где находится точка, например в области метки или изображения. Если координаты находятся за пределами элемента управления, возвращаемый ListViewHitTestInfo объект имеет Location свойство None, а Item свойствам и SubItem присваивается значение null.

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

HitTest(Int32, Int32)

Предоставляет сведения об элементе, заданным координатами x и y.

public:
 System::Windows::Forms::ListViewHitTestInfo ^ HitTest(int x, int y);
public System.Windows.Forms.ListViewHitTestInfo HitTest (int x, int y);
member this.HitTest : int * int -> System.Windows.Forms.ListViewHitTestInfo
Public Function HitTest (x As Integer, y As Integer) As ListViewHitTestInfo

Параметры

x
Int32

Координата x, для которой требуется извлечь сведения об элементе. Координата указывается относительно левого верхнего левого угла элемента управления.

y
Int32

Координата y, для которой требуется извлечь сведения об элементе. Координата указывается относительно левого верхнего левого угла элемента управления.

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

Сведения об элементе, заданном координатами X и Y.

Исключения

Координата x или y отрицательна.

Примеры

В следующем примере кода показано использование HitTest метода для определения расположения события мыши в ListView. Чтобы запустить этот пример, вставьте его в форму Windows Forms, содержащую ListView объект с именем listView1 , заполненный элементами. Свяжите MouseDown событие для listView1 с методом listView1_MouseDown в этом примере.

void HandleMouseDown(object sender, MouseEventArgs e)
{
    ListViewHitTestInfo info = listView1.HitTest(e.X, e.Y);
    MessageBox.Show(info.Location.ToString());
}
Private Sub HandleMouseDown(ByVal sender As Object, ByVal e As MouseEventArgs) _
        Handles Me.MouseDown, listView1.MouseDown

    Dim info As ListViewHitTestInfo = listView1.HitTest(e.X, e.Y)
    MessageBox.Show(info.Location.ToString())

End Sub

Комментарии

Используйте этот метод, чтобы определить, находится ли точка в элементе или вложенном элементе и где находится точка, например в области метки или изображения. Если координаты находятся за пределами элемента управления, возвращаемый ListViewHitTestInfo объект имеет Location свойство None, а Item свойствам и SubItem присваивается значение null.

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