ListView.HitTest Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

Перегрузки

HitTest(Point)	Предоставляет сведения об элементе, заданном точкой.
HitTest(Int32, Int32)	Предоставляет сведения об элементе, заданным координатами x и y.

HitTest(Point)

Исходный код:

ListView.cs

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

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

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

Исключения

ArgumentOutOfRangeException

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

Комментарии

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

HitTest(Int32, Int32)

Исходный код:

ListView.cs

Предоставляет сведения об элементе, заданным координатами 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, для которой требуется извлечь сведения об элементе. Координата указывается относительно левого верхнего левого угла элемента управления.

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

ListViewHitTestInfo

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

Исключения

ArgumentOutOfRangeException

Координата 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.